Guides
Sessions and tabs
Start, split, find, rename and close sessions in the desktop app and the phone app.
Start a session on any of your machines, fill it with terminal tabs and agent chats, and pick it up from your computer or phone.
Pick your system to see its keys:
Start a session
Each machine has a card in the sidebar, with its sessions inside.
- Click + on the machine's card. The new session shows under the machine and asks what its first tab should be.
- Choose Terminal for a shell, or Agents for a coding agent. The tab opens.
- On Home, tap the new-session button at the bottom right, or + on a machine's card.
- If you have more than one machine online, tap the one you want.
- Tap Terminal for a shell, or an agent under Agents. The session opens on that tab.
To name a new session yourself, start it from search, below.
Find a session on any machine
Click a session in the sidebar to open it, or unfold it to see its tabs.
To search every machine, press ⌘K. The session picker opens.
- Narrow it to one machine: click its name button at the top, or type
machine/session, such asbuild/ci. - Start a named session: type the name, then press ⌘↩.
- Do something else: start with
@to pick a machine,#to switch workspace, or>to run an app action.
Tap a session on Home. To switch from there, see Open a session.
To search every machine, or start a session with your own name, see Search for anything.
A session shows its most urgent tab's mark, such as when an agent needs your OK. The desktop shows it while the session is folded, the phone always. See Get notified.
Add a tab
A tab shows its program's tile, such as for a shell or for Claude Code, its name and its mark.
Press ⌘T for a terminal tab, or ⌥⌘T for New agent chat.
- Add a tab: tap + at the end of the tab bar, at the bottom, then Terminal or Agent chat. You pick the agent next. With no agents installed, + adds a terminal tab straight away. Or swipe left past the last tab to pick Terminal or an agent.
- Switch tab: tap it, or swipe sideways across the terminal.
- Go back to Home: swipe right past the first tab.
The tab you switch to becomes the session's current tab on every device.
Put tabs side by side
Splits are saved on the machine, so every device gets them.
- On a tab's header, click Split right or Split down.
- Pick Terminal or Agents. The new tab opens alongside.
- Resize: drag the line between two tabs.
- Move a tab: drag its header onto another tab: on an edge to split there, in the middle to swap.
- Focus on one tab: click Full screen on it. Back to session brings the others back.
The phone shows each part of a split as its own tab, with a small drawing of where it sits when you switch. A tab you add on the phone goes to the right of the one on screen.
See tabs from different machines together
In the desktop app, a group puts tabs from different machines side by side. Groups stay on this computer, under Groups in the sidebar.
- Drag a tab from another machine in the sidebar onto what's open, or use the key on Keyboard shortcuts.
- The tab joins the group, still in its own session, with its machine's name on a coloured badge (colours are in Settings).
In a group, × only takes the tab off the screen; it keeps running in its session. A group goes away with its last tab.
Rename or close
- Rename a session: double-click its row, type the new name and press Enter. Use letters, numbers,
.,_and-. - Rename a tab: hover it, then More › Rename tab.
- Close a tab: click × on its header. This ends what runs in it, without asking. In full screen, × only takes it off the screen.
- Delete a session: hover its row and click the trash. chaar asks first, because this ends everything in it. Closing its last tab deletes the session too, after asking.
- Rename or delete a session: long-press its row on Home. Deleting asks first.
- Rename or close a tab: long-press it in the tab bar. Closing ends what runs in it, without asking.
See whether a machine is online
Click a machine's header to fold its card. On the phone, tap an online machine's header. The header says how the machine is doing:
| The header shows | What it means |
|---|---|
| up 3h | The machine is online, and chaar has been running there for 3 hours. |
| Online | The machine is online. Phone only. |
| getting access…, reaching…, loading sessions… | The phone is connecting to the machine. |
| shared | Someone else in your workspace owns it. Desktop only. |
| Offline | You can't open it. See Troubleshooting. |
| Refused this device | It turned this device away, often because your versions differ or you no longer have access. See Troubleshooting. |
Machines shared from other workspaces are under Shared with me: see Share with others.
Next: Work with AI agents.
Stuck? Ask in the Discord community.