chaarDocsDownloadConsole

Reference

Keyboard shortcuts

Every key in the desktop app and every gesture in the phone app.

Find the key or gesture for what you're doing, on any device.

Steps for

Desktop app

Bold names match Settings › Keyboard Shortcuts, which lists more actions with no key until you give them one. To change a key, see Settings.

Sessions and tabs

ActionKeys
Session picker (search and switch sessions)⌘K
New session⌘N
Next session, Previous session⌘] ⌘[
New terminal tab, New agent chat⌘T ⌥⌘T
Next tab, Previous tab⌃Tab ⌃⇧Tab
Rename tab (press again to rename its session)⌘R
Close the tab⌘W
Bring in another machine: show a tab from another machine next to this one⌘I

Split a tab

Each part of a split is its own tab.

ActionKeys
Split right, down: terminal⌘D ⇧⌘D
Split right, down: agent chat⌥⌘A ⌥⇧⌘A
Fill the window with this tab, and back⌘↩
Go to the tab next to this one⌥⌘ + an arrow
Make this tab bigger or smaller⌃⌘ + an arrow
Move this tab⌥⇧⌘ + an arrow

Chat with an agent

ActionKeys
Send message↩
New line⇧↩
Cycle mode: switch to the agent's next mode⇧Tab
Mention a file@
Allow once, Always allow⌘Y ⌥⌘Y
Show or hide the files the agent changed⇧⌘E
Say no to an agent that asks for your OK. Otherwise, stop the agent.Esc

Work in a terminal tab

ActionKeys
Copy, Paste⌘C ⌘V
Find in the terminal's history⌘F
Select text when the program uses the mouse⇧ + drag
Bigger, smaller, reset text size⌘= ⌘- ⌘0
Open a link⌘ + click it

Move around the app

ActionKeys
Next agent waiting on you⌘J
Command palette⇧⌘P
Show or hide sidebar⌘B
Settings⌘,
The shortcut sheet: a card with the keys you'll use most⌘/
Quit chaar⌘Q

Quitting chaar also stops your other devices reaching this Mac: see Install on your computer.

Pick a session

These work in the session picker.

ActionKeys
Move, open↑ ↓ ↩
Create a session with the name you typed⌘↩
Close the selected tab on its machine. A session's last tab asks to delete the session first.⌘⌫
Next or previous machineTab ⇧Tab

The chaar command

The keys for the chaar command are on Terminal commands.

Phone app

Home

GestureWhat it does
Swipe left or rightChange workspace
Tap a machine's nameFold or unfold its sessions
Long-press a machine's nameWho has access
Long-press a sessionRename or delete it

Tabs

GestureWhat it does
Swipe left or rightNext or previous tab
Swipe left past the last tabPick a new tab: Terminal or an agent
Swipe right past the first tabBack to Home
Long-press a tab in the tab barRename or close it
Tap + in the tab barNew tab

Terminal

GestureWhat it does
TapBring up the keyboard
DragScroll back
PinchChange the text size

Key bar

The bar of keys above the phone's keyboard is described on Use chaar on your phone.

Stuck? Ask in the Discord community.

↑↓Move↩Open