Keyboard Shortcuts
Primary shortcut
Toggle Normal ↔ Quake presentation
Switches the same live workspace between presentations without restarting shells. This is different from global F12, which shows or hides Quake.
toggle-presentation
Application/global
| Action | Default shortcut | Action ID |
|---|---|---|
| Toggle Normal ↔ Quake | Cmd+Opt+P | toggle-presentation |
| Show/hide Quake globally | F12 | quicktty-global-toggleConfig key, outside local action registry |
| Open configuration | Cmd+Comma | open-config |
| Quit QuickTTY | Cmd+Q | quit |
Tabs/panes
| Action | Default shortcut | Action ID |
|---|---|---|
| New tab | Cmd+T | new-tab |
| Close pane | Cmd+W | close-pane |
| Close tab | Cmd+Opt+W | close-tab |
| Split right | Cmd+D | split-right |
| Split down | Cmd+Shift+D | split-down |
| Previous pane | Cmd+Left-Bracket | previous-pane |
| Next pane | Cmd+Right-Bracket | next-pane |
| Focus left | Cmd+Shift+Left | focus-left |
| Focus right | Cmd+Shift+Right | focus-right |
| Focus up | Cmd+Shift+Up | focus-up |
| Focus down | Cmd+Shift+Down | focus-down |
| Select tab 1 | Cmd+1 | select-tab-1 |
| Select tab 2 | Cmd+2 | select-tab-2 |
| Select tab 3 | Cmd+3 | select-tab-3 |
| Select tab 4 | Cmd+4 | select-tab-4 |
| Select tab 5 | Cmd+5 | select-tab-5 |
| Select tab 6 | Cmd+6 | select-tab-6 |
| Select tab 7 | Cmd+7 | select-tab-7 |
| Select tab 8 | Cmd+8 | select-tab-8 |
| Select tab 9 | Cmd+9 | select-tab-9 |
| Toggle broadcast | Cmd+B | toggle-broadcast |
Workspaces
| Action | Default shortcut | Action ID |
|---|---|---|
| Select workspace 1 | Cmd+Opt+1 | select-workspace-1 |
| Select workspace 2 | Cmd+Opt+2 | select-workspace-2 |
| Select workspace 3 | Cmd+Opt+3 | select-workspace-3 |
| Select workspace 4 | Cmd+Opt+4 | select-workspace-4 |
| Select workspace 5 | Cmd+Opt+5 | select-workspace-5 |
| Select workspace 6 | Cmd+Opt+6 | select-workspace-6 |
| Select workspace 7 | Cmd+Opt+7 | select-workspace-7 |
| Select workspace 8 | Cmd+Opt+8 | select-workspace-8 |
| Select workspace 9 | Cmd+Opt+9 | select-workspace-9 |
Search/terminal
| Action | Default shortcut | Action ID |
|---|---|---|
| Find | Cmd+F | find |
| Find next | Cmd+G | find-next |
| Find previous | Cmd+Shift+G | find-previous |
| Copy | Cmd+C | copy |
| Paste | Cmd+V | paste |
| Paste selection | Cmd+Shift+V | paste-selection |
| Select all | Cmd+A | select-all |
| Clear screen | Cmd+K | clear-screen |
| Increase font size | Cmd+Equal | font-increase |
| Decrease font size | Cmd+Minus | font-decrease |
| Reset font size | Cmd+0 | font-reset |
| Scroll to top | Cmd+Home | scroll-top |
| Scroll to bottom | Cmd+End | scroll-bottom |
| Scroll page up | Cmd+Page-Up | scroll-page-up |
| Scroll page down | Cmd+Page-Down | scroll-page-down |
| Scroll to selection | Cmd+J | scroll-to-selection |
| Extend selection left | Shift+Left | selection-left |
| Extend selection right | Shift+Right | selection-right |
| Extend selection up | Shift+Up | selection-up |
| Extend selection down | Shift+Down | selection-down |
| Extend selection page up | Shift+Page-Up | selection-page-up |
| Extend selection page down | Shift+Page-Down | selection-page-down |
| Extend selection to home | Shift+Home | selection-home |
| Extend selection to end | Shift+End | selection-end |
No default shortcut
These typed actions are available for customization but are unassigned by default.
| Action | Action ID |
|---|---|
| New workspace | new-workspace |
| Rename workspace | rename-workspace |
| Delete workspace | delete-workspace |
| Copy URL | copy-url |
| Reset terminal | reset-terminal |
| Previous prompt | previous-prompt |
| Next prompt | next-prompt |
Customize shortcuts
Local commands use repeatable assignments. An action receives a chord or the literal value disabled:
quicktty-shortcut = action-id=cmd+key
quicktty-shortcut = action-id=disabledA chord has optional modifiers and exactly one key separated by +. Modifiers are cmd, opt, ctrl, and shift; canonical order is cmd+opt+ctrl+shift+key. Supported keys include letters, digits, F1–F20, arrows, navigation and named punctuation such as left-bracket, minus, and slash. A single key such as f12 is valid.
Assignment and conflict behavior
Parsing starts from the built-in defaults and processes repeated quicktty-shortcut lines from top to bottom. For each action, the last valid assignment wins; disabled is a valid assignment.
An unknown action or malformed assignment reports a diagnostic without blocking other valid lines. During hot reload, an invalid assignment for a known action preserves that action’s last active value. Deleting every assignment for an action restores its built-in default.
If two local actions use the same chord, the last valid owner wins and the previous owner becomes disabled. The separately registered global Quake chord takes priority over any conflicting local action.