Keyboard shortcuts
Keyboard shortcuts for the Cusp desktop app and the cusp terminal UI.
Desktop app
On macOS these live in the menu bar. Windows and Linux have no menu bar, so the app binds the same shortcuts with Ctrl in place of ⌘.
Sessions and navigation
| Action | macOS | Windows, Linux |
|---|---|---|
| New session | ⌘N | Ctrl+N |
| Open folder | ⌘O | Ctrl+O |
| Command palette | ⌘K | Ctrl+K |
| Toggle sidebar | ⌘B | Ctrl+B |
| Toggle terminal | ⌃` | Ctrl+` |
| Find | ⌘F | Ctrl+F |
| Settings | ⌘, | Ctrl+, |
| Keyboard shortcuts | ⌘/ | Ctrl+/ |
Window
| Action | Shortcut |
|---|---|
| Show or hide Cusp from anywhere | ⌘⇧Space on macOS, Ctrl+Shift+Space elsewhere |
The show-or-hide shortcut is global: it works while another app is focused. It can be changed or turned off.
On macOS the standard window commands are handled natively:
| Action | macOS |
|---|---|
| Close window | ⌘W |
| Minimize | ⌘M |
| Full screen | ⌃⌘F |
| Actual size | ⌘0 |
| Zoom in | ⌘= |
| Zoom out | ⌘− |
| Hide Cusp | ⌘H |
| Quit | ⌘Q |
Undo, redo, cut, copy, paste and select all use the usual platform shortcuts everywhere.
On macOS, closing the window hides Cusp and the Dock icon brings it back. ⌘Q quits, which also stops the daemon. On Windows and Linux, closing the window quits.
Tray
The tray icon menu offers Show, New Session and Quit.
Terminal UI
Composer
| Key | Action |
|---|---|
| Enter | Send |
Shift+Enter, or \ then Enter | New line |
| ↑ / ↓ | Previous and next prompt from history (when the cursor is on the first or last line) |
| Tab | Accept the highlighted completion |
| Ctrl+V | Paste an image from the clipboard |
| Ctrl+D | Exit, when the prompt is empty |
While the agent works
| Key | Action |
|---|---|
| Esc | Interrupt the agent |
| Esc Esc | With a draft: clear it (↑ brings it back). With an empty prompt: rewind to an earlier prompt |
| Ctrl+C | Interrupt, or clear the prompt. Press twice within 1.5 s to exit |
| Shift+Tab | Cycle permission mode: default → accept edits → plan → auto |
| Ctrl+O | Expand tool output and reasoning |
| Ctrl+T | Show or hide the task list |
| Ctrl+L | Redraw the screen |
Permission prompts
| Key | Action |
|---|---|
| ↑ / ↓, Tab | Move between choices |
| Enter | Choose the highlighted option |
| y | Allow once |
| n, Esc | Deny |
Pickers and menus
| Key | Action |
|---|---|
| ↑ / ↓, Tab | Move |
| Enter | Choose |
| Esc | Cancel |
Prompt prefixes
| Prefix | Action |
|---|---|
/ | Commands and skills |
@ | Mention a file |
! | Run a shell command and share its output |
Type /help or ? in the terminal UI to see this list in context.