Skip to content

Overview

Pick the smallest way that does the job:

To Use
Change how the hub or a tool looks, or add a small touch to it A mod: CSS, a little JS and color themes
Show a page next to Kanban’s terminal that follows the open session An add-on on the dock rail
Change what a tool does A patch, or a fork when the patch grows
Add a tool that does a different job A new app in a tab of its own

To share any of them, make it an extension. claude-code-hub ext install adds it to the hub, and the Extensions page lists the ones you can install.

The hub runs each tool from a folder. An entry in config.json can point a tool at your own folder, so you can change a tool and keep the hub as it is. There are three ways to do it, from the smallest change to the largest:

What the hub runs You maintain Patch the published package patch One patch file per version Fork your copy of the tool source A copy of the tool New app your app A complete app
What runs in each way: the accent part is yours
  • A patch changes a few lines in the published package.
  • A fork changes any part of the tool’s source.
  • A new app changes nothing in the existing tools.

Start with a patch. When the patch gets large or breaks on each upgrade, go to a fork. When the tool you want does a different job, write a new app.

Each way ends with an entry in the apps list of config.json:

{
"apps": [
{ "id": "kanban-patched", "path": "C:/dev/kanban-patched" },
{ "id": "kanban", "enabled": false }
]
}
  • path is the folder of your tool. It can be any folder on the machine. A relative path starts from the folder of config.json. The hub does not expand ~, so write the full path.
  • id must be the same as the id in the folder’s hub-app.json.
  • To replace a built-in tool, use its id, for example kanban. To run your tool next to the original, give it a new id.

Restart the hub after you edit the file. See The config file for the other keys.

Only one tool gets the embedded terminal and the project list: the first enabled tool in tab order that declares it in provides. If your tool and the original both declare them, the hub logs a message at startup. Turn one off, or put the one you want first.

Alt+1 to Alt+9 follow the tab order, so the tool you put first is also Alt+1. On macOS, the keys are ⌃⌥1 to ⌃⌥9, and the tab examples in these pages work the same way.

  • Compact session rows: a patch that changes the Kanban session list to two-line rows.
  • Task board: a fork that keeps the Kanban server and replaces its page with a new board.
  • Inspector: a new app that shows the turns, tool calls and token use of one session.