Guides
Use chaar in a terminal
Sign in with the chaar command, open your sessions from any terminal, and leave them running when you go.
The chaar command opens your sessions from any terminal. You can leave a session running and come back to it with one command.
You see the same sessions and tabs as in the desktop app and on your phone. In a terminal, a session's tabs show side by side, each in its own frame (the screen calls them panes).
Every command, flag and key is in Terminal commands.
Get the command
On a Mac with the desktop app, choose Install Command Line Tool… in the menu bar. On Windows and Linux, the desktop app's installer adds the command. See Add the chaar command.
On any other computer, install the command on its own:
$ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/sixtythreelabs/chaar-releases/releases/download/cli/v0.1.0-alpha.3/chaar-installer.sh | sh$ brew install sixtythreelabs/tap/chaarThen open a new terminal window.
Sign in
You can skip this step: chaar, chaar list, chaar connect and chaar kill start the same sign-in when you aren't signed in.
-
Run:
Terminal $ chaar loginYour browser opens. If it doesn't, open the link the terminal prints on any device.
-
Choose Authenticate CLI within 5 minutes. The terminal prints
logged in.
On a machine with no browser, run chaar login --headless instead. It prints a link you can open on your laptop or phone.
Browse your machines and sessions
-
Run:
Terminal $ chaarThe session browser opens. Your workspaces are across the top, and
Sharedcomes last when someone has shared a machine with you. -
Press tab to move between workspaces. The list shows each machine, its sessions under it, and each session's tabs under those. A machine that's offline is dim and says
offline. -
Move with the arrows, or j and k. The right and left arrows, or l and h, unfold and fold a row.
The bottom of the screen shows the keys for the row you're on, and ? lists them all. To find a session, press / and type part of its name. q quits.
Open a session
- Select a session and press enter. To open it on one tab, select that tab instead.
- The session fills your terminal. The top bar shows the machine's name, its sessions, whether you're connected, and how many things need you. Each tab has its own frame, and the tab you're typing in has a highlighted frame.
To start a new session, press n on a machine, or on anything under it. It starts with one terminal tab and opens right away.
Keys inside a session
Everything you type goes to the program in the tab, except keys that start with the prefix, ctrl-b. Press ctrl-b, let go, then press the next key. For example, ctrl-b% splits the tab with a new terminal to its right, and ctrl-b? lists every session key.
Using tmux? You can change the prefix: see Change the keys.
Leave and come back later
-
Press ctrl-bd.
chaarcloses, and the session keeps running on the machine. -
When you want it back, run:
Terminal $ chaar connectIt reopens the last session you opened with
chaaron this computer.
Leaving never stops a session. A session ends only when you delete it or close its last tab. Typing exit in the last tab ends the session too.
If the connection drops, the tab dims and chaar keeps reconnecting by itself. See Troubleshooting if it doesn't come back.
Leave with ctrl-b d
ctrl-c goes to the program in the tab, and it can stop that program. To leave, press ctrl-bd.
Jump straight into a session
chaar connect opens a session from your shell, without the session browser.
| Command | What it opens |
|---|---|
chaar connect <session> | The session with that name, on any online machine. |
chaar connect -n <session> | A new session with that name. |
For example, chaar connect api opens the session called api. What happens when no session has that name, and the flags that pick a workspace or machine, are in chaar connect.
Next
- Terminal commands: every command, every key, and how to change the keys.
- Sessions and tabs: what sessions and tabs are, on every device.
- Work with AI agents: agent chats run in the desktop app and on your phone.
Stuck? Ask in the Discord community.