hobhob
Customizing

Keyboard shortcuts

Every default binding, the two-axis convention behind them, and how to rebind them.

hob follows a two-axis convention: Alt moves you around — focus and swap panes, create and close panes and workspaces, jump and cycle between workspaces — while Cmd/Ctrl performs actions — open panels, the command palette, settings, zoom. That is why jumping to a workspace is Alt+1Alt+9 rather than the browser-style Cmd+1Cmd+9: it lives on the navigation axis by design.

Notation. Cmd/Ctrl means Cmd on macOS and Ctrl elsewhere. Alt is the Option (⌥) key on macOS. A few bindings use plain Ctrl on every platform, noted where they appear.

App

ActionShortcut
Command paletteCmd/Ctrl+K or Cmd/Ctrl+Shift+P
Go to fileCmd/Ctrl+P
Open folderCmd/Ctrl+O
New workspaceAlt+N
New windowCmd/Ctrl+Shift+N
SettingsCmd/Ctrl+,
Keyboard shortcutsCmd/Ctrl+/
App menu (Windows/Linux)Alt+F
Remote popupAlt+R
License popoverAlt+L
QuitCmd/Ctrl+Q

Tool panels

These shortcuts open the panel (they don't toggle it). Only Cmd/Ctrl+B toggles the whole sidebar.

PanelShortcut
HomeCmd/Ctrl+Shift+M
Explorer (files)Cmd/Ctrl+Shift+E
ActivityCmd/Ctrl+Shift+A
Search in filesCmd/Ctrl+Shift+F
WorkflowsCmd/Ctrl+Shift+X
StatsCmd/Ctrl+Shift+U
BookmarksCmd/Ctrl+Shift+B
Local issuesCmd/Ctrl+Shift+I
Remote issuesCmd/Ctrl+Shift+R
ChangesCmd/Ctrl+Shift+D
GitCmd/Ctrl+Shift+H
Switch projectCmd/Ctrl+Shift+L
Cycle open projectsCmd/Ctrl+Shift+O (back: Cmd/Ctrl+Shift+Alt+O)
Switch branchCmd/Ctrl+Shift+K
Toggle sidebarCmd/Ctrl+B

File search lives inside the Explorer panel: Cmd/Ctrl+Shift+F opens it directly with the search box focused, or open Explorer (Cmd/Ctrl+Shift+E) and switch to the Search view.

Panes

ActionShortcut
New agent paneAlt+A
New agent pane (force new)Alt+Shift+A
New terminal paneAlt+T
New browser paneAlt+U
Expand / collapse paneAlt+Enter
Pin / unpin paneAlt+Shift+P
Bookmark paneAlt+Shift+B
Share paneAlt+Shift+S
Pane actions menuAlt+.
Close paneAlt+W

Alt+W closes a pane; Alt+Q — next door on the keyboard — closes a workspace, and Alt+Shift+Q closes all workspaces.

Pane navigation

ActionShortcut
Focus pane (left/right/up/down)Alt+← Alt+→ Alt+↑ Alt+↓
Swap pane (left/right/up/down)Alt+Shift+← Alt+Shift+→ Alt+Shift+↑ Alt+Shift+↓
Equalize gridAlt+Shift+E

Workspaces

ActionShortcut
Next workspaceAlt+PgDn
Previous workspaceAlt+PgUp
Jump to workspace 1–9Alt+1Alt+9
Close workspaceAlt+Q
Close all workspacesAlt+Shift+Q

All workspace chords are Alt-based, so they work everywhere — including browser and roam modes, where Cmd/Ctrl+T, Cmd/Ctrl+W, and Ctrl+Tab belong to the browser.

Agent pane

These fire only while an agent pane is focused:

ActionShortcut
Model pickerAlt+M
Reasoning effortAlt+E
Backend / profileAlt+B
Toggle plan modeAlt+P
Toggle auto-acceptAlt+Y
Toggle fast modeAlt+S
Cycle permission modeShift+Tab
Stop agentCmd/Ctrl+C or Esc Esc

Esc Esc (a quick double-press) stops only while the agent is running and the pane is focused. Cmd/Ctrl+C and Shift+Tab are reserved — see below.

Zoom

ActionShortcut
Zoom inCmd/Ctrl+= (or Cmd/Ctrl+Shift++)
Zoom outCmd/Ctrl+-
Reset zoomCmd/Ctrl+0

Zoom applies to the desktop app only — these bindings do nothing in browser, headless, or roam modes.

Other

ActionShortcut
Find in paneCmd/Ctrl+F
Save (render pane)Cmd/Ctrl+S
Quick fix (issues)Cmd/Ctrl+Enter
Search settingsCmd/Ctrl+F (in Settings)

Customizing shortcuts

Open the shortcuts editor with Cmd/Ctrl+/, or open Settings and click Shortcuts.

  • Rebind — click a binding and press the new combination.
  • Add a second binding — click the empty badge next to an action; any action can have more than one binding.
  • Disable — clear a binding and it shows as an em dash ().
  • Defaults — hover a customized binding to see its default; set it back manually to restore it.

When you record a chord that's already in use, hob shows a conflict dialog"X is used by Action" with Reassign or Cancel.

Reserved shortcuts. Stop agent (Cmd/Ctrl+C) and Cycle permission mode (Shift+Tab) are fixed conventions — they appear in the editor with a lock and can't be rebound or reassigned.

In browser, headless, gateway, and roam modes, some chords are claimed by the browser itself (Cmd/Ctrl+T, Cmd/Ctrl+W, Ctrl+Tab, Cmd/Ctrl+N, Cmd/Ctrl+Q, devtools) and can't be intercepted. Every default binding avoids those chords, so hob works fully by keyboard in remote modes. The command palette (Cmd/Ctrl+K) is the always-available fallback.

How is this guide?

On this page