Skip to content

Keyboard shortcuts

The hub has no visible controls. These keys drive it. They work while focus is inside a tool, because each tool sends them to the hub.

Key Action
Ctrl+Alt+→ Next tool
Ctrl+Alt+← Previous tool
Alt+1 Kanban
Alt+2 Marketplace
Alt+3 Cost
Alt+4 Memory Diagnoser
Ctrl+Alt+P Open or close the project palette
Ctrl+Alt+W Open or close the config-dir palette, or switch to the previous dir (see Switch with one key)
Ctrl+Alt+A Open or close the app launcher
Ctrl+, Open or close the hub settings
Ctrl+Shift+R Reload the hub without the “Reload app?” prompt. The terminals keep running.

The number keys follow the tab order. The table shows the default order. The apps list in the config file changes it, and a tool that is off has no number.

A hub key names the character on the key, as on a US keyboard. The hub finds it the same way on every layout:

  • On a Latin layout, such as French, German or Dvorak, it matches the key that types that character. On French AZERTY, Ctrl+, is the key labelled ,, and Ctrl+Alt+A is the key labelled A.
  • On a layout with no Latin letters, such as Ukrainian, Russian or Greek, it matches the key in the same place on a US keyboard. So Ctrl+Alt+P works while you type in Cyrillic, and Ctrl+, is the key that types б.
  • The digit row always counts as digits, so Alt+1 is the key labelled 1 on any layout, AZERTY’s & key too.

The shortcuts window in the hub settings shows, next to such a key, the character your layout types on it.

On a layout with AltGr, such as Polish or German, Windows sends AltGr as Ctrl+Alt. When the press types a character, for example AltGr+A types ą on a Polish layout, the hub leaves it to the tool, so you can type it. A hub key whose letter types a character on your layout does not work there. To use another key, see Change the keys.

On macOS, the hub keys use Control (⌃), not Command. All but the hub settings key are Control+Option (⌃⌥) with a key, the tool numbers too:

Key Action
⌃⌥→ / ⌃⌥← Next or previous tool
⌃⌥1 … ⌃⌥9 Go to a tool by its number
⌃⌥P, ⌃⌥W, ⌃⌥A Project palette, config-dir palette, app launcher
⌃, Hub settings
⌘⇧R Reload the hub without the “Reload app?” prompt

Option with a digit types a character on macOS, for example Option+5 types [ on a German layout. The hub does not bind it, so you can type these characters in every tool.

Open the hub settings (Ctrl+,) and select Customize… on the Keyboard page. For each hub action:

  • Change waits for a key. Press the new key with at least one modifier, or Esc to cancel. For App by number, press the modifiers with any digit.
  • Reset gives the action its default key.
  • Off removes the action’s key.

A change applies at once, in the hub and in every tool, with no restart. When the key is in use by another hub action, that action’s key turns off. A key a tool keeps is refused. The window lists those keys under the tool’s name.

The window saves the keys in a keys block in the config file. You can also edit the block by hand, then restart the hub. Each entry sets the key of one hub action:

{
"keys": {
"hub.projectPicker": "ctrl+alt+o",
"hub.appByNumber": "ctrl+shift+{n}",
"hub.configDirPicker": null
}
}
Action Default Default on macOS
hub.projectPicker ctrl+alt+p ctrl+alt+p
hub.configDirPicker ctrl+alt+w ctrl+alt+w
hub.appLauncher ctrl+alt+a ctrl+alt+a
hub.settings ctrl+, ctrl+,
hub.prevApp ctrl+alt+ArrowLeft ctrl+alt+ArrowLeft
hub.nextApp ctrl+alt+ArrowRight ctrl+alt+ArrowRight
hub.appByNumber alt+{n} ctrl+alt+{n}
hub.reload ctrl+shift+r shift+meta+r
hub.voice ctrl+shift+Space (with voice on) ctrl+shift+Space
  • A key is one or more of ctrl, alt, shift and meta, then a letter, a digit, one of , . ; ' ` / \ = - [ ], or a key name such as ArrowUp or F2, joined by +. On macOS, alt is Option and meta is Command. Case does not matter, except in a key name.
  • hub.appByNumber ends in +{n}. The hub puts the tool number, 1 to 9, in place of {n}.
  • null turns the action’s key off.
  • When you give an action the default key of another action, that other action has no key until you give it one.
  • The hub logs an entry and keeps the default for it when the entry is not valid, when another entry has the same key, or when a tool keeps that key, for example Ctrl+Alt+N in Kanban.
  • The app launcher shows the keys of the tool numbers you set, and the help of each tool (?) shows the hub keys you set. A tool hides a hub row that has no key.
  • The keys inside each tool stay as they are. A key you give the hub does not reach the tool.
Key Action
↓ or Tab Next row
↑ or Shift+Tab Previous row
Enter Pick the selected row
Ctrl+D Config-dir palette: remove the selected dir from the list
Ctrl+C App launcher: copy the URL of the selected tool (when no text is selected in the search box)
Ctrl+R App launcher: restart the selected tool
Ctrl+S App launcher: stop the selected tool, or start it when it is stopped
Esc Close the palette

While a palette is open, the tool keys do nothing, so you can type a path that has digits in it.

The app launcher lists the tools in tab order, each with the host and port it runs on. Each row shows the tool’s version and, for Kanban, its Claude Code plugin; the footer shows the hub and its plugin. A ⚠ marks a plugin that is not installed, is disabled, or is not the version the tool ships, in the active config dir. Click it to copy the install command. Each row also shows the memory and CPU of the tool’s process; 100% is one core. The ⧉ and ↻ buttons on a row copy its URL and restart it, as Ctrl+C and Ctrl+R do. A slow port badge means the tool’s port delays requests; a restart moves the tool to a new port. When it opens, the tool you used before the current one is selected, so Ctrl+Alt+A then Enter goes back to it. A restart stops the tool’s process and starts it again, then reloads its tab. A Kanban restart ends its embedded terminals, so when terminals are open the launcher asks you to press Ctrl+R a second time. The ■ button, or Ctrl+S, stops the tool’s process: the hub does not start it again, and its tab says it is stopped. On a stopped tool the button shows ▶ and starts it. A Kanban stop also asks twice when terminals are open.

Select a session in Kanban, then:

Key Action
$ Open Cost for the session
M Open Marketplace for the session’s project
Ctrl+M Open Memory Diagnoser for the session’s project

Kanban uses these keys itself and does not send them to the hub:

Key Action
Ctrl+Alt+N New session
Ctrl+Alt+R Resume session
Ctrl+Alt+S Swap to the previous session
Ctrl+Alt+Shift+S Go to the next session that needs you: first the ones that wait for your answer, then the unread ones. Press again for the one after it

Each tool has its own keys. Press ? in a tool to see them, or read its docs: