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
| Action | Keys |
|---|---|
| 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.
| Action | Keys |
|---|---|
| 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
| Action | Keys |
|---|---|
| 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
| Action | Keys |
|---|---|
| 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
| Action | Keys |
|---|---|
| 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.
| Action | Keys |
|---|---|
| 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 machine | Tab ⇧Tab |
The chaar command
The keys for the chaar command are on Terminal commands.
Phone app
Home
| Gesture | What it does |
|---|---|
| Swipe left or right | Change workspace |
| Tap a machine's name | Fold or unfold its sessions |
| Long-press a machine's name | Who has access |
| Long-press a session | Rename or delete it |
Tabs
| Gesture | What it does |
|---|---|
| Swipe left or right | Next or previous tab |
| Swipe left past the last tab | Pick a new tab: Terminal or an agent |
| Swipe right past the first tab | Back to Home |
| Long-press a tab in the tab bar | Rename or close it |
| Tap + in the tab bar | New tab |
Terminal
| Gesture | What it does |
|---|---|
| Tap | Bring up the keyboard |
| Drag | Scroll back |
| Pinch | Change 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.