Keyboard Shortcuts
Keyboard Shortcuts
SubFrame provides keyboard shortcuts for fast navigation and terminal management. Press Ctrl+? (Ctrl+Shift+/) at any time to open the in-app shortcuts overlay.
All shortcuts use Ctrl on Windows/Linux and Cmd (⌘) on macOS unless noted otherwise.
General
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+, | ⌘+, | Open Settings |
| Ctrl+? | ⌘+? | Open keyboard shortcuts help |
| Escape | Escape | Close overlay / navigate back in full-view |
Sidebar
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+B | ⌘+B | Toggle sidebar (show/hide) |
| Ctrl+E | ⌘+E | Focus project list in sidebar |
| Ctrl+Shift+E | ⌘+Shift+E | Focus file tree in sidebar |
Terminal
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+Shift+T | ⌘+Shift+T | Create new terminal |
| Ctrl+Shift+W | ⌘+Shift+W | Close current terminal |
| Ctrl+Tab | ⌘+Tab | Switch to next terminal |
| Ctrl+Shift+Tab | ⌘+Shift+Tab | Switch to previous terminal |
| Ctrl+1 through Ctrl+9 | ⌘+1 through ⌘+9 | Jump to terminal by position |
| Ctrl+Shift+G | ⌘+Shift+G | Toggle grid/tabs view |
| Ctrl+C | ⌘+C | Copy selected text (when text is selected) |
| Ctrl+V | ⌘+V | Paste from clipboard |
Double-click to rename
Double-click any terminal tab to rename it. Press Enter to confirm or Escape to cancel.
Panels
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+Shift+S | ⌘+Shift+S | Toggle Sub-Tasks panel |
| Ctrl+Shift+A | ⌘+Shift+A | Toggle Agent Activity panel |
| Ctrl+Shift+P | ⌘+Shift+P | Toggle Plugins panel |
| Ctrl+Shift+H | ⌘+Shift+H | Toggle History panel |
| Ctrl+Shift+G | ⌘+Shift+G | Toggle GitHub panel |
Shared shortcut
Ctrl+Shift+G is mapped to both the grid view toggle and the GitHub panel. The grid view toggle takes priority when a terminal is active.
Navigation
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+Shift+[ | ⌘+Shift+[ | Switch to previous project |
| Ctrl+Shift+] | ⌘+Shift+] | Switch to next project |
Full-View Overlays
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+Shift+O | ⌘+Shift+O | Toggle project overview (full-view) |
| Ctrl+Shift+K | ⌘+Shift+K | Toggle Sub-Tasks full-view |
| Escape | Escape | Close full-view or navigate back to overview |
Editor
These shortcuts are available when the file editor is open.
| Shortcut | macOS | Action |
|---|---|---|
| Ctrl+S | ⌘+S | Save file |
| F11 | F11 | Toggle editor fullscreen |
File Tree
When the file tree panel is focused, use these keys to navigate:
| Key | Action |
|---|---|
| Arrow Up / Arrow Down | Move focus between files |
| Arrow Right | Expand focused directory |
| Arrow Left | Collapse focused directory |
| Enter | Open focused file in editor |
Tips
- The in-app shortcuts overlay (Ctrl+?) provides a quick visual reference without leaving your workflow.
- Tooltips on toolbar buttons show their keyboard shortcuts -- hover over any button to discover its shortcut.
- Terminal tabs can be reordered and renamed via the right-click context menu.
- Mouse back button navigates back in full-view overlays, matching the Escape behavior.