Appendix
D. Keyboard shortcuts
The live reference is the in-TUI How-to Guide **Keyboard Shortcuts** (/docs → Keyboard Shortcuts). Bindings are built in and cannot be remapped.
This page does not copy the full binding tables. It only names the mode split, focus, and the few keys every session uses.
Related: Everyday conversation and the screen; Attach files with @.
Simple vs vim
| Mode | How to get it | Scrollback letters |
|---|---|---|
| Simple (default) | [ui] vim_mode = false | Arrows move selection; a letter focuses the prompt and types |
| Vim | /vim-mode or [ui] vim_mode = true | j/k move; h/l fold; g/G top/bottom; y copy |
Arrow keys, Tab, Esc, Space, PageUp/PageDown, and every Ctrl+letter chord work in both modes. Single-letter and Shift+letter scrollback bindings require vim mode.
Prompt vs scrollback
| Focus | How you get there | What keys do |
|---|---|---|
| Prompt | Tab / Space from scrollback (also i in vim) | Enter sends; Tab returns to scrollback |
| Scrollback | Tab from the prompt | Navigate / fold the conversation |
Esc is not a focus key. It cancels, clears, or rewinds. Mid-turn Esc cancels and keeps the draft, except in fullscreen vim mode, where it does not cancel (Ctrl+C instead).
The shortcuts bar at the bottom names the keys for the focused pane.
Attach, palette, quit
| Key | Action | See |
|---|---|---|
@ | File search / attach (prompt) | Attach files with @ |
Paste (Cmd+V / Ctrl+V; Alt+V for images on Windows) | Text, files, screenshots | Paste and chips |
Ctrl+P or ? | Command palette (shortcuts, slash commands, skills). /help opens the same surface | Live catalog vs written tutorial |
Ctrl+Q | Quit (double-press within 1000 ms). VS Code family terminals: Ctrl+D is the sole quit key | Quit and restore the terminal |
There is no key for the welcome screen; use /home (/welcome).