Reference: Keyboard Shortcuts

The complete, authoritative shortcut table. Source of truth: supacode/App/AppShortcuts.swift (app actions) and supacode/Commands/*.swift (menu wiring). Terminal-level keys come from the Ghostty engine.

Keywords:keyboardshortcutshotkeyskeybindingskey bindingsremap⌘commandshortcut list

Symbols: ⌘ Command · ⇧ Shift · ⌥ Option · ⌃ Control · ↩ Return · ⌫ Delete · arrows ↑ ↓ ← →

Defaults shown. Most rows are user-remappable (see Remapping). To see a human’s live binding, the Command Palette displays the resolved key next to each action. Automation should use the prowl CLI, which never depends on keybindings.

Worktrees & repositories#

Action	Default	Command ID	Remappable
New Worktree	⌘N	`new_worktree`	yes
Open Worktree (with the selected Open-in app)	⌘O	`open_worktree`	yes
Open Repository…	⌘⇧O	`open_repository`	yes
Open on Code Host (e.g. GitHub)	⌘⌃G	`open_pull_request`	yes
Refresh Worktrees	⌘⇧R	`refresh_worktrees`	yes
Archived Worktrees (panel)	⌘⌃A	`archived_worktrees`	yes
Select Next Worktree (cycles tabs in Shelf view)	⌘⌃↓	`select_next_worktree`	yes
Select Previous Worktree (cycles tabs in Shelf view)	⌘⌃↑	`select_previous_worktree`	yes
Back in Worktree History	⌘⌥[	`worktree_history_back`	yes
Forward in Worktree History	⌘⌥]	`worktree_history_forward`	yes
Select Worktree 1–9	⌃1 … ⌃9	`select_worktree_1` … `_9`	yes
Reveal in Sidebar	⌘⇧L	`reveal_in_sidebar`	yes
Rename Branch	⌘⇧M	`rename_branch`	yes (local)
Archive Worktree	(menu only, no default key)	—	—
Delete Worktree	⌘⇧⌫	(menu-bound, fixed)	no
Confirm Worktree Action (in dialogs)	⌘↩	(menu-bound, fixed)	no

View & layout#

Action	Default	Command ID	Remappable
Toggle Left Sidebar	⌘⌃S	`toggle_left_sidebar`	yes
Toggle Active Agents Panel	⌘⌥P	`toggle_active_agents_panel`	yes
Toggle Agent Island hot window	Unassigned	`toggle_agent_island`	yes
Select Next Agent (in panel)	⌥⌃↓	`select_next_active_agent`	yes
Select Previous Agent (in panel)	⌥⌃↑	`select_previous_active_agent`	yes
Jump to Latest Unread	⌘⌥U	`jump_to_latest_unread`	yes
Show Diff	⌘⇧Y	`show_diff`	yes
Show Outgoing Changes	⌘⌥⇧Y	`outgoing_changes`	yes
Toggle Canvas	⌘⌥↩	`toggle_canvas`	yes
Toggle Shelf	⌘⇧↩	`toggle_shelf`	yes

Agent Island deliberately ships without a shortcut. Assign Toggle Agent Island under Settings → Agents → Display or Settings → Shortcuts. Both use the same recorder and conflict handling. The globe beside the command explains its system-wide scope on hover. Prowl registers the resolved shortcut globally only while Agent Island has entries and Prowl is in the background; while Prowl is active, the normal menu key equivalent handles it. A globally registered chord takes precedence over the frontmost application’s matching shortcut until the island becomes inactive or Prowl returns to the foreground. If macOS cannot register the shortcut globally, the shortcut row in either settings page reports the failure until the binding changes or a later registration succeeds. Reset returns the command to Unassigned.

In the open roster, Arrow Up or k and Arrow Down or j select; Arrow Left or h and Arrow Right or l page; Return opens (Space is an alias); 1…9 directly opens a current-page row even when shortcut modifiers remain held; and Esc closes. Opening selects the newest Blocked reminder first, then the newest unviewed Done reminder, before falling back to the focused agent.

Shelf view#

Action	Default	Command ID	Remappable
Select Next Book	⌘⌃→	`select_next_shelf_book`	yes
Select Previous Book	⌘⌃←	`select_previous_shelf_book`	yes
Select Book 1–9	⌥⌃1 … ⌥⌃9	`select_shelf_book_1` … `_9`	yes

In Shelf view, ⌘⌃←/→ flips between books (worktrees) and ⌘⌃↑/↓ cycles the tabs of the open book (those are the select_previous/next_worktree actions).

Canvas view#

Action	Default	Command ID	Remappable
Select All Canvas Cards	⌘⌥A	`select_all_canvas_cards`	yes (local)
Arrange Canvas Cards (pack to fit)	⌘⌥R	`arrange_canvas_cards`	yes (local)
Organize Canvas Cards (uniform grid)	⌘⌥G	`organize_canvas_cards`	yes (local)
Tile Canvas Cards (fill viewport)	⌘⌥T	`tile_canvas_cards`	yes (local)
Expand / Restore Canvas Card	⌘⌥E	`expand_canvas_card`	yes (local)
Clear selection	Esc	—	—
Zoom	⌘ + scroll, or pinch	—	—

Terminal tabs & panes#

These app actions are also registered with Ghostty, so they work while a terminal pane has focus. The Ghostty action each maps to is shown for reference.

Action	Default	Command ID	Ghostty action
Select Terminal Tab 1–9	⌘1 … ⌘9	`select_terminal_tab_1` … `_9`	`goto_tab:N`
Select Previous Tab	⌘⇧[	`select_previous_terminal_tab`	`previous_tab`
Select Next Tab	⌘⇧]	`select_next_terminal_tab`	`next_tab`
Select Previous Pane	⌘[	`select_previous_terminal_pane`	`goto_split:previous`
Select Next Pane	⌘]	`select_next_terminal_pane`	`goto_split:next`
Select Pane Up	⌘⌥↑	`select_terminal_pane_up`	`goto_split:up`
Select Pane Down	⌘⌥↓	`select_terminal_pane_down`	`goto_split:down`
Select Pane Left	⌘⌥←	`select_terminal_pane_left`	`goto_split:left`
Select Pane Right	⌘⌥→	`select_terminal_pane_right`	`goto_split:right`
Toggle Split Zoom	⌘⌥⇧F	`toggle_split_zoom`	`toggle_split_zoom`
Find	⌘F	`start_search`	—
Find Next	⌘G	`find_next`	—
Find Previous	⌘⇧G	`find_previous`	—

Terminal engine (Ghostty-managed)#

These are not Prowl app shortcuts; they are Ghostty terminal bindings, shown in Prowl’s Terminal menu with whatever key Ghostty resolves. Customize them in your Ghostty config (~/.config/ghostty/config). Typical defaults in parentheses.

Action	Ghostty action	Typical default
New Terminal (tab)	`new_tab`	⌘T
Close Terminal (pane/surface)	`close_surface`	⌘W
Close Terminal Tab	`close_tab`	⌘⇧W
Undo Close (restore the last closed pane / tab)	`undo`	⌘Z, ⌘⇧T
Redo Close (close it again)	`redo`	⌘⇧Z
New Split (vertical / horizontal)	`new_split:right` / `new_split:down`	(Ghostty default; config-only, not in the Terminal menu)
Reset Font Size	`reset_font_size`	⌘0
Increase Font Size	`increase_font_size:1`	⌘+
Decrease Font Size	`decrease_font_size:1`	⌘-
Hide Find Bar	`end_search`	Esc
Use Selection for Find	`search_selection`	⌘E

App & global#

Action	Default	Command ID	Remappable
Command Palette	⌘P	`command_palette`	yes
Open Settings	⌘,	`open_settings`	yes
Run Script	⌘R	`run_script`	yes
Stop Script	⌘.	`stop_script`	yes
Check for Updates	⌘⇧U	`check_for_updates`	yes
Quit Application	⌘Q	`quit_application`	no (fixed)

Plus any enabled global or per-repository Custom Commands, which can each carry their own hotkey — see components/custom-actions.md.

Remapping & customization#

App actions (scope configurableAppAction) are remappable in Settings → Shortcuts. Overrides are stored in ~/.prowl/settings.json under keybindingUserOverrides.
While recording a remappable shortcut, choose Clear to leave the action unassigned. The empty shortcut field can be recorded again, or Reset can restore the default binding.
quit_application is fixed (systemFixedAppAction) — it can’t be remapped.
Canvas/local actions (localInteraction, e.g. Arrange/Organize/Expand, Rename Branch) are remappable and conflict-checked against all remappable actions.
Custom Command hotkeys take precedence over app shortcuts within the focused repository. Local commands win global-command collisions; global bindings use a separate internal command ID namespace. Recording an app shortcut already used by an active Custom Command is rejected; pre-existing collisions are marked Unavailable in Shortcuts.
Disabling a Custom Command unregisters its hotkey with every other command surface, but preserves the configured key so re-enabling restores it.
Terminal engine keys are owned by Ghostty. Prowl automatically unbinds any Ghostty key that collides with an app shortcut, and re-binds the tab/pane-navigation actions into Ghostty so they work inside the terminal. You customize the rest in ~/.config/ghostty/config.

Notes for agents#

These are defaults. If a human says “my ⌘P does X”, trust them — they may have remapped it. The CLI is binding-independent; prefer it for automation.
When two rows look like they share keys (e.g. ⌥⌃↑/↓ for agent navigation vs ⌘⌥↑/↓ for pane navigation), check the modifiers carefully — Control vs Command distinguishes them.
select_previous/next_worktree (⌘⌃↑/↓) is overloaded by design: in Shelf view it cycles the open book’s tabs; elsewhere it changes the selected worktree.

Recent input close protection#

Closing a pane or tab asks for confirmation if any affected pane received text, paste, dropped text or file paths, or deletion input within the last 10 seconds. Active input-method composition also requires confirmation, even after 10 seconds. This applies to idle agents and ordinary terminals, alongside existing protection for active agents, unseen results, and long-running commands.

Navigation, copying, scrolling, and the close shortcut itself do not extend this window. Enter and Escape do not clear it. This guards against accidental closure while editing; it does not detect saved drafts or protect input indefinitely. Explicit no-confirmation close operations retain their existing behavior.

Undo close#

Closing a pane or tab keeps it alive for Ghostty’s undo-timeout (default 5 seconds). Within that window, Ghostty’s undo binding (⌘Z or ⌘⇧T by default) from any terminal puts the most recently closed pane or tab back where it was: same tab position, same split position and ratio, same running process and scrollback. redo (⌘⇧Z) closes it again without a confirmation prompt. Batch closes (Close Other Tabs, Close Tabs to the Right, Close All) come back as one unit.

Each close has its own timer; a later close does not extend an earlier one. The undo history is app-wide and time-ordered: ⌘Z restores the latest close even if it happened in another tab or worktree, and Prowl selects that worktree and tab (in Canvas, the restored card becomes the primary selection) so the restore is visible. A pane launched from an Agent Profile keeps its Profile identity, managed-hook signals, and Codex notification forwarding across the restore. Closing the last tab of a worktree is undoable too: with no terminal left to take the key, the main window hands it to Ghostty’s app-level binding dispatch, so your real undo / redo bindings apply (defaults ⌘Z, ⌘⇧T, ⌘⇧Z; rebinding, unbinding, and performable: prefixes are honored) and the tab comes back into that worktree (and the book back onto the Shelf). A text field that has focus keeps its own undo, other windows are not affected, and no other app-level binding fires through this route. When nothing is restorable, ⌘Z reaches the terminal program as a normal key.

Not restorable: closes whose process had already exited, worktree removal, layout restore, Run Script replacement, and a pane whose tab was split or rearranged after the close. Set undo-timeout = 0 in ~/.config/ghostty/config to disable the feature.