Keyboard Shortcuts
The TUI supports multiple keyboard binding styles: CUA (standard), macOS, and Emacs.
Navigation
| Action | Keys |
|---|---|
| Move up | ↑ |
| Move down | ↓ |
| Move left | ← |
| Move right | → |
| Page up | Page Up |
| Page down | Page Down |
| Next control | Tab |
| Previous control | Shift+Tab |
Task Actions
| Action | Keys |
|---|---|
| New draft task | Ctrl+N |
| Launch task | Enter |
| Delete task | Ctrl+W |
| Stop/Pause task | Pause |
Text Editing
| Action | CUA | macOS | Emacs |
|---|---|---|---|
| New line | Shift+Enter | Shift+Enter | Shift+Enter |
| Beginning of line | Home | Cmd+← | Ctrl+A |
| End of line | End | Cmd+→ | Ctrl+E |
| Word forward | Ctrl+→ | Alt+→ | Alt+F |
| Word backward | Ctrl+← | Alt+← | Alt+B |
| Delete word forward | Ctrl+Delete | Alt+Delete | Alt+D |
| Delete word backward | Ctrl+Backspace | Alt+Backspace | Alt+Backspace |
| Delete to end of line | — | — | Ctrl+K |
Clipboard
| Action | CUA | macOS | Emacs |
|---|---|---|---|
| Cut | Ctrl+X | Cmd+X | Ctrl+W |
| Copy | Ctrl+C | Cmd+C | Alt+W |
| Paste | Ctrl+V | Cmd+V | Ctrl+Y |
Selection
| Action | Keys |
|---|---|
| Select all | Ctrl+A / Cmd+A |
| Extend selection | Shift + movement keys |
General
| Action | Keys |
|---|---|
| Show help | ? |
| Dismiss modal | Esc |
| Quit TUI | Ctrl+C (twice) |
| Undo | Ctrl+Z / Cmd+Z |
| Redo | Ctrl+Y / Cmd+Shift+Z |
Modal Navigation
When in a modal dialog (agent selector, repository selector, etc.):
| Action | Keys |
|---|---|
| Navigate options | ↑, ↓ |
| Select option | Enter |
| Cancel | Esc |
| Adjust value | ←, → or +, - |
| Filter/search | Start typing |
Agent Selector Modal
| Action | Keys |
|---|---|
| Move selection | ↑, ↓ |
| Increase count | + or → |
| Decrease count | - or ← |
| Toggle selection | Enter (adds 1 if count is 0) |
| Filter agents | Type to search |
| Confirm | Enter |
| Cancel | Esc |
Customization
Key bindings can be customized in the configuration file:
[tui.keymap]
draft-new-task = "Ctrl+N"
activate-current-item = "Enter"
dismiss-overlay = "Esc"See Configuration for details.