chaarDocsDownloadConsole

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:

Steps for

Start a session

Each machine has a card in the sidebar, with its sessions inside.

  1. Click + on the machine's card. The new session shows under the machine and asks what its first tab should be.
  2. Choose Terminal for a shell, or Agents for a coding agent. The tab opens.
session-1
Pick its first tab on studio
Terminal
Agents
Drawing of an empty session in the desktop app.

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 as build/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.

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.

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.

  1. On a tab's header, click Split right or Split down.
  2. 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.

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.

  1. Drag a tab from another machine in the sidebar onto what's open, or use the key on Keyboard shortcuts.
  2. 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.

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 showsWhat it means
up 3hThe machine is online, and chaar has been running there for 3 hours.
OnlineThe machine is online. Phone only.
getting access…, reaching…, loading sessions…The phone is connecting to the machine.
sharedSomeone else in your workspace owns it. Desktop only.
OfflineYou can't open it. See Troubleshooting.
Refused this deviceIt 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.

↑↓Move↩Open