Zide uses a hierarchical shortcut system. Shortcuts are scoped to the active context — shortcuts from deeper layers take priority when that context is active.
Shortcut Layers
From lowest to highest priority:
- App — always active
- Project Tab — active when a repository or worktree Project Tab is focused
- Content Tab — active for the current content tab type
- Mode — active for the current mode within a content tab
Viewing All Shortcuts
Press Ctrl+/ or F1 to open the keyboard shortcuts dialog. It shows all shortcuts across the hierarchy, including which layers are currently active or inactive.
App Shortcuts
On macOS, Ctrl maps to Cmd, except tab cycling (Ctrl+Tab / Ctrl+Shift+Tab) which stays on the physical Control key, since Cmd+Tab is the macOS application switcher.
| Shortcut | Action |
|---|
| Ctrl+/ or F1 | Open keyboard shortcuts |
| Ctrl+Tab | Next content tab |
| Ctrl+Shift+Tab | Previous content tab |
| Ctrl+W | Close active content tab |
| Ctrl+Alt+S | Save All (all dirty file tabs across all Project Tabs) |
Switching content tabs with Ctrl+Tab
Ctrl+Tab opens the most-recently-used (MRU) tab switcher. Hold Control to keep it open, move the selection, then release Control to switch. Enter also confirms and Esc cancels.
- Windows / Linux: move the selection with Tab / Shift+Tab or the arrow keys.
- macOS: move the selection with Tab / Shift+Tab. The arrow keys are not available here because macOS reserves Control+arrow for Mission Control and Spaces, so those keypresses never reach Zide while Control is held.
Layout Shortcuts
| Shortcut | Layout |
|---|
| Alt+1 | Single Pane |
| Alt+2 | Side by Side |
| Alt+3 | Stacked Right |
| Alt+4 | Three Columns |
Project Tab Shortcuts
These require the relevant repository capability (git, issues, etc.):
| Shortcut | Action |
|---|
| Ctrl+Shift+A | Open Actions |
| Ctrl+Shift+B | Open Branches |
| Ctrl+Shift+G | Open Tags |
| Ctrl+Shift+H | Open Stashes |
| Ctrl+Shift+L | Open Reflog |
| Ctrl+Shift+R | Open Worktrees |
| Ctrl+Alt+6 | Open Script Runner |
| Alt+Shift+B | Open Browser |
Content Tab Shortcuts
Some content tabs define their own shortcuts when active:
File Browser
| Shortcut | Action |
|---|
| Ctrl+F | Toggle filter bar |
| Up/Down or J/K | Navigate files |
| Left/Right | Collapse/expand folders |
Reflog
| Shortcut | Action |
|---|
| Up/Down | Select entry |
| Enter | Toggle diff |
| C | Reset to entry |
| R | Refresh |
Actions
| Shortcut | Action |
|---|
| Up/Down or j/k | Select run |
| Enter | Open in browser |
PR Changed Files
| Shortcut | Action |
|---|
| j/k | Next/previous file |
| n/p | Next/previous change |
| e | Expand/collapse |
Tab Navigation
| Shortcut | Action |
|---|
| Alt+Left | Back (detail tabs) |
| Alt+Right | Forward (detail tabs) |
Notes
- Shortcuts use key position (
event.code), so they work consistently across keyboard layouts
- When a Terminal tab is active, most shortcuts are passed through to the terminal
- Text input fields take priority over single-key shortcuts
