// hub directory

Hub: Every .md & .html, one page.

Point Hub at a folder. It indexes every Markdown and HTML file inside into full-text search with task lineage, and serves a fast local browser — split-pane preview, kind filters, activity view, timeline. No npm. No framework. Pure stdlib Python.

pip install hubspaces View on GitHub →

Then cd into any project and run hub serve — or try it instantly: hub serve --demo.

Hub index — every document in one searchable page

// what it does

Full-text search across title, body, path, and repo — implicit AND, repo:name prefix.
Split-pane preview with a // trace panel linking runs, artifacts, and the parent task.
Task board & status badges — click to cycle ongoing → completed → paused, persisted.
Timeline drawer & activity view — 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

# install (isolated)
pipx install hubspaces

# browse any folder
cd ~/my-project
hub serve             # http://localhost:8787, rebuilds on change

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