Keyboard Shortcuts
Complete keyboard shortcut reference covering global shortcuts, chord shortcuts, editor shortcuts, and the command palette.
Stoa uses a layered shortcut system: global shortcuts that work everywhere, chord shortcuts for workspace navigation, and editor-specific shortcuts for text editing.
Global Shortcuts
These work across the entire application:
| Shortcut | Action |
|---|---|
| Cmd+K / Ctrl+K | Open/close command palette |
| [ | Toggle left sidebar |
| ] | Toggle right sidebar (agent panel) |
| Escape | Close modal/dialog, or exit editor focus |
Chord Shortcuts
Chord shortcuts use a two-key sequence inspired by Vim. Press G (the leader key), then press a second key within 1.5 seconds.
When you press G, a visual indicator appears showing G -> while waiting for the second key.
Note
Chord shortcuts only work in command mode. If you're focused on the editor, press Escape first to enter command mode.
Layout
| Chord | Action |
|---|---|
| G V | Switch to Video layout |
| G S | Switch to Split layout |
| G C | Switch to Project (code) layout |
Sidebar Navigation
| Chord | Action | Context |
|---|---|---|
| G F | Navigate to Files | All workspaces |
| G B | Navigate to Bookmarks | All workspaces |
| G D | Navigate to Decisions | Space workspaces only |
| G K | Navigate to Meeting Context | Space workspaces only |
| G M | Navigate to Meeting | Space workspaces only |
| G T | Navigate to Transcript | Space workspaces only |
| G R | Navigate to Recordings | Space workspaces only |
Actions
| Chord | Action |
|---|---|
| G N | Create new file |
| G A | Start agent |
| G P | Switch project (when multiple projects available) |
| hold ` | Voice to agent (push-to-talk, when available) |
Editor Shortcuts
These work when the editor is focused:
Text Formatting (Markdown)
| Shortcut | Action |
|---|---|
| Cmd+B / Ctrl+B | Toggle bold |
| Cmd+I / Ctrl+I | Toggle italic |
Search
| Shortcut | Action |
|---|---|
| Cmd+F / Ctrl+F | Open find panel |
Comments
| Shortcut | Action |
|---|---|
| Cmd+Shift+M / Ctrl+Shift+M | Add comment to selection |
| Cmd+Enter / Ctrl+Enter | Submit comment |
| Escape | Cancel comment |
Auto-Save
| Shortcut | Action |
|---|---|
| Cmd+S / Ctrl+S | Intercepted: shows auto-save acknowledgment (no browser save dialog) |
Command Mode
| Shortcut | Action |
|---|---|
| Escape | Exit editor focus, enter command mode (enables workspace shortcuts) |
Chat Shortcuts
| Shortcut | Action |
|---|---|
| Cmd+Enter / Ctrl+Enter | Send chat message |
CLI Access (Account Settings)
These shortcuts work on the CLI Access tab in Account Settings:
| Shortcut | Action |
|---|---|
| Ctrl+C | Copy device code |
| Ctrl+L | Generate new code |
Dashboard
| Shortcut | Action |
|---|---|
| Ctrl+1 through Ctrl+4 | Switch between dashboard tabs |
| Ctrl+R | Refresh dashboard |
Command Palette Actions
When the command palette is open (Cmd+K), these navigation shortcuts apply:
| Shortcut | Action |
|---|---|
| Arrow Up / Down | Navigate items |
| Enter | Select item |
| Escape | Close palette |
The command palette shows available actions with their chord shortcuts, serving as both a quick launcher and a shortcut reference.
Available Actions
Navigate:
- Search and open files
- Switch between projects
Layout:
- Video layout (G V)
- Split layout (G S)
- Project layout (G C)
- Toggle left sidebar ([)
- Toggle agent sidebar (])
Sidebar:
- Decisions (G D)
- Meeting Context (G K)
- Meeting (G M)
- Transcript (G T)
- Recordings (G R)
- Files (G F)
- Bookmarks (G B)
Actions:
- Create new file (G N)
- Start agent (G A)
- Switch project (G P)
- Voice to agent (hold `)
Desktop App (macOS)
| Shortcut | Action |
|---|---|
| Cmd+P | Quick Open (file finder) |
Platform Notes
- On macOS, shortcuts use Cmd
- On other platforms, shortcuts use Ctrl
- The UI automatically shows the correct modifier for your platform