v0.1.0 — Hub

Hub — point it at a folder and get every .md and .html inside as one searchable, previewable page. Stdlib-only Python, no runtime dependencies.

First public release: installable from PyPI, runnable on your own files in one command.

Install

pipx install hubspaces     # isolated (recommended)
# or
pip install hubspaces

Two commands land on your PATH: hub (build the index) and hub-server (serve it + watch for changes).

Quick start

cd ~/my-project
hub-server                 # http://localhost:8787, rebuilds on change
# or try it instantly on a bundled example:
hub-server --demo

Highlights

• Full-text search over 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 — cycle ongoing → completed → paused, persisted across rebuilds and branch switches.
• Feed & Timeline drawers — recent file activity and git-backed daily summaries.
• Auto-rebuild — file watcher refreshes the index within ~3 s of any change.
• Zero-config or hub.toml — scan_root, port, exclude_dirs, default_view; hub init scaffolds a stub.

Optional agent plugin

hub-agent bundles the manifest skill (the producer of the task manifests Hub indexes). Fully opt-in — hub-core needs no plugin:

/plugin marketplace add auth-02/hub
/plugin install hub-agent@hub

Requirements & support

• Python 3.11+ (uses stdlib tomllib).
• macOS is the validated platform for v1; Linux runs in CI. Windows/WSL not yet validated.
• License: MIT.

Links

• Docs / landing: https://auth-02.github.io/hub/
• Source: https://github.com/auth-02/hub

🤖 Generated with Claude Code