Keyboard shortcuts
Every shortcut Kettu has, grouped as the app's own shortcut list groups them.
To see this list in the app, press ⌘/ on macOS or Ctrl+/ on Windows and Linux, or click Keyboard shortcuts at the bottom of the sidebar.
Sessions
| Action | macOS | Windows and Linux |
|---|---|---|
| New session | ⌘N | Ctrl+N |
| Previous session in the sidebar | ⌘⇧[ | Ctrl+Shift+[ |
| Next session in the sidebar | ⌘⇧] | Ctrl+Shift+] |
| Focus the composer | ⌘L | Ctrl+L |
| Add files or photos to the composer | ⌘U | Ctrl+U |
| Focus pane 1 to 9 of the split view | ⌘1 to ⌘9 | Ctrl+1 to Ctrl+9 |
| Cancel the running turn | Esc | Esc |
| Answer the pending permission request | 1 to 4 | 1 to 4 |
Previous and next session follow the sidebar’s order across pinned sessions, projects and No project. See Permission requests for the keys that answer a request.
Window
| Action | macOS | Windows and Linux |
|---|---|---|
| Open project | ⌘O | Ctrl+O |
| Toggle the sidebar | ⌘B | Ctrl+B |
| Back | ⌘[ | Alt+← |
| Forward | ⌘] | Alt+→ |
| Settings; Esc goes back | ⌘, | Ctrl+, |
| Zoom in | ⌘= | Ctrl+= |
| Zoom out | ⌘- | Ctrl+- |
| Reset the zoom to 100% | ⌘0 | Ctrl+0 |
| Show the keyboard shortcuts | ⌘/ | Ctrl+/ |
The mouse’s back and forward buttons also go back and forward.
Terminal
| Action | macOS | Windows and Linux |
|---|---|---|
| Show or hide the terminal | ⌃` | Ctrl+` |
| New terminal | ⌃⇧` | Ctrl+Shift+` |
| Ask the agent about the selection, with text selected in the terminal | ⌘L | Ctrl+L |
The terminal keys use Ctrl on macOS too, and work while a project is open.
When a terminal or the editor has focus
On Windows and Linux, while a terminal has focus, only the terminal and zoom shortcuts reach Kettu, since Ctrl+B, Ctrl+L and Ctrl+N mean something to the shell, and Alt+← and Alt+→ move by a word. The Files pane’s editor keeps ⌘/ or Ctrl+/, which comments lines, and ⌘[ and ⌘].
In the composer
Which key sends is set by Send with in Settings › General; the other one inserts a new line.
| Action | With Enter (default) | With ⌘ Enter or Ctrl+Enter |
|---|---|---|
| Send | Enter | ⌘Enter or Ctrl+Enter |
| New line | Shift+Enter | Enter |
| Queue a message while the agent works | Enter | ⌘Enter or Ctrl+Enter |
| Steer the running turn | ⌘Enter or Ctrl+Enter | ⌘⇧Enter or Ctrl+Shift+Enter |
Steering works with agents that take messages during a turn.
Elsewhere
| Action | macOS | Windows and Linux |
|---|---|---|
| Search Settings | ⌘F | Ctrl+F |
| Filter the Artifacts page by title | ⌘F | Ctrl+F |
| Save the file in the Files pane | ⌘S | Ctrl+S |