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.
Other keyboard layouts
Section titled “Other keyboard layouts”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 labelledA. - 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
1on 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.
Change the keys
Section titled “Change the keys”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,shiftandmeta, then a letter, a digit, one of, . ; ' ` / \ = - [ ], or a key name such asArrowUporF2, joined by+. On macOS,altis Option andmetais Command. Case does not matter, except in a key name. hub.appByNumberends in+{n}. The hub puts the tool number, 1 to 9, in place of{n}.nullturns 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.
Palettes
Section titled “Palettes”| 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.
From a Kanban session
Section titled “From a Kanban session”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 |
Keys Kanban keeps
Section titled “Keys Kanban keeps”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 |
Keys inside each tool
Section titled “Keys inside each tool”Each tool has its own keys. Press ? in a tool to see them, or read its docs: