// a record of why, for agent-driven work

Your agent produces. Hub links it. You trace it.

Point Hub at a folder — every task, decision, run, and diagram becomes one searchable, traceable page. The manifest records what you decided, what the agent decided, what it found, and the plan; lineage makes that record navigable, so nothing your agent makes floats free. No npm. No framework. Pure stdlib Python — nothing leaves your machine.

pip install hubspaces View on GitHub →

Two ways in: pip install hubspaces for the standalone package, or /plugin install hub@hub for the batteries-included Claude Code plugin (engine bundled, works offline). Then hub serve — or try it instantly: hub serve --demo.

Hub index — every document in one searchable page

// what it does

Lineage trace — every run, artifact, prompt, and diagram traces back to the task and the decision that produced it, via a // trace panel.
Diagrams in place — create Excalidraw diagrams in the UI, offline; task diagrams are first-class lineage nodes.
Full-text search across title, body, path, and repo — implicit AND, repo:name prefix.
Task board & status badges — click to cycle ongoing → completed → paused, persisted.
Timeline — what changed, which task, when; daily summaries pulled from git.
Auto-rebuild — a file watcher refreshes the index within ~3 s of any change.

// get started

# package — standalone, isolated install
pipx install hubspaces
cd ~/my-project
hub serve             # http://localhost:8787, rebuilds on change

# plugin — batteries-included for Claude Code (engine bundled, offline)
/plugin marketplace add auth-02/hub
/plugin install hub@hub
/hub:serve            # producer skills + the viewer, one install

Configure with a hub.toml (hub init scaffolds one): scan root, port, excluded dirs, default view.