Keyboard Shortcuts
Claudette supports keyboard shortcuts for fast navigation and common actions. Hold ⌘ (macOS) or Ctrl (Linux) to reveal shortcut badges on UI elements. Tooltips and command-palette shortcut labels use your current Settings → Keyboard bindings, so disabled or rebound shortcuts are reflected in the UI.
Shortcut Reference
Section titled “Shortcut Reference”Navigation
Section titled “Navigation”| Shortcut | Action |
|---|---|
⌘/Ctrl + B | Toggle sidebar |
⌘/Ctrl + D | Toggle diff panel (right sidebar). Terminal panes use terminal-only D bindings instead; see Terminal Panes. |
⌘/Ctrl + ` | Toggle terminal panel |
⌘/Ctrl + , | Open/close settings |
⌘⇧W (macOS) | Close the window (hides to tray on macOS). ⌘W is reserved for the terminal — see Terminal Panes. |
Tabs & Navigation
Section titled “Tabs & Navigation”The unified tab strip holds chat sessions, diff tabs, file tabs, and any other workspace tabs in one drag-reorderable row. The bracket shortcuts cycle the strip in order, with wrap-around.
| Shortcut | Action |
|---|---|
⌘/Ctrl + T | New tab — chat session by default, or new file when a file is open |
⌘/Ctrl + W | Close the active tab |
⌘/Ctrl + Shift + [ | Previous tab in the unified tab strip |
⌘/Ctrl + Shift + ] | Next tab in the unified tab strip |
⌘/Ctrl + 1 – ⌘/Ctrl + 9 | Jump to project by index |
⌘/Ctrl + Shift + N | New workspace in the current project |
⌘/Ctrl + Shift + N resolves which project to target in this order: the project-scoped view’s pinned repo → the active workspace’s repo → the first local repo. The new workspace is auto-named, the parent repo group is force-expanded in the sidebar, and the workspace is selected so you land in its chat view.
To switch between workspaces in the same project, click them in the sidebar or use the fuzzy finder (⌘/Ctrl + K) — the bracket shortcuts no longer specifically cycle workspaces, since the unified tab strip subsumed that intent.
Search & Commands
Section titled “Search & Commands”| Shortcut | Action |
|---|---|
⌘/Ctrl + K | Toggle fuzzy finder (workspace search) |
⌘/Ctrl + P | Toggle command palette |
| Shortcut | Action |
|---|---|
Shift + Tab | Toggle plan mode |
Escape | Dismiss current overlay, or stop running agent |
Voice Input
Section titled “Voice Input”| Shortcut | Action |
|---|---|
⌘⇧M (macOS) / Ctrl+Shift+M (Linux/Windows) | Toggle voice recording |
Right ⌥ (macOS only) | Hold to record, release to transcribe |
Both shortcuts are customisable in Settings → Keyboard → Voice. The hold-to-talk key is macOS-only by default but can be bound to any key on any platform. See Voice Input for provider setup.
Terminal Panes
Section titled “Terminal Panes”These fire only when a terminal pane has keyboard focus — they shadow the
equivalent global shortcuts where applicable (e.g. ⌘D toggles the diff
panel when the chat is focused but splits the terminal on macOS when the
terminal is focused; Linux/Windows keep bare Ctrl+D for shell EOF and use
Ctrl+Shift+D instead).
| Shortcut | Action |
|---|---|
⌘D (macOS) / Ctrl+Shift+D (Linux) | Split pane side-by-side |
⌘⇧D (macOS) / Ctrl+Shift+Alt+D (Linux) | Split pane stacked |
⌘W (macOS) / Ctrl+Shift+W (Linux) | Close the focused pane (or the tab when it’s the last pane) |
⌘⌥←/→/↑/↓ (macOS) / Ctrl+Alt+arrow (Linux) | Move focus to the neighboring pane |
⌘T (macOS) / Ctrl+Shift+T (Linux) | New terminal tab |
⌘⇧[ / ⌘⇧] | Previous / next terminal tab |
Escape Key Priority
Section titled “Escape Key Priority”When multiple overlays are open, Escape dismisses them in this order:
- Command Palette
- Settings
- Modal dialogs
- Fuzzy Finder
- Diff panel
- Stop running agent
Keyboard Hint Badges
Section titled “Keyboard Hint Badges”When you hold ⌘ (macOS) or Ctrl (Linux) without pressing another key, Claudette shows shortcut badges on relevant UI elements — sidebar toggle, diff panel, terminal, and settings buttons. Release the modifier key to hide them. Hover tooltips show the same current binding when the related shortcut is enabled.