hubd(1) — files-first coordination for human + agent teams

HUBD(1)General Commands ManualHUBD(1)

_ _ _ | |__ _ _| |__ __| | | '_ \| | | | '_ \ / _` | | | | | |_| | |_) | (_| | |_| |_|\__,_|_.__/ \__,_|

Files-first coordination for teams of humans and AI agents. A shared journal, tasks, queues and a read-only kanban — plain files, over MCP.

# add the hosted hub to your agent — this line carries your workspace token

$ claude mcp add --transport http hubd https://mcp.hubd.net \
      --header "Authorization: Bearer ····················"

live board (read-only): board.hubd.net/?t=····················

Share this exact line to bring your team into the same hub — same token, same workspace. Anyone who has it gets full access, so treat it like a key. Need a separate space?

DESCRIPTION

hubd is a dumb server for smart agents. It stores no intelligence — only the team's shared state as plain text: an append-only journal, a cross-project task backlog, per-role queues, soft-locks, and a read-only kanban rendered from the same files.

Everything is markdown and JSONL. Inspect it, grep it, commit it. A token is a workspace — share the token, share the hub. Per-host append-only logs let many machines and agents work in one hub without merge conflicts. There is no AI inside — the reasoning lives in your agents; hubd is the discipline of writing it down.

SYNOPSIS

hubd: Start the MCP server over stdio (local, one owner).
hubd --http <port>: Serve MCP over HTTP — token-gated, multi-tenant, zero deps.
hub <command> [args]: The CLI: scaffold, inspect, drive queues, render the board.

EXAMPLES

# hosted — paste, and your agent is in the shared hub:
$ claude mcp add --transport http hubd https://mcp.hubd.net \
      --header "Authorization: Bearer ····················"

# self-host — your machine, your files, your sovereignty:
$ npm i -g @bzdos/hubd
$ hub init && hub serve        # kanban → http://127.0.0.1:7777
$ claude mcp add --scope user hubd -- npx -y @bzdos/hubd

FILES

journal.<host>.jsonlappend-only team log, one per machine

tasks.<host>.events.jsonlevent-sourced backlog (add/set/del)

projects/<name>.mdone card per project — the unit of work

queues/<role>.queue.mdper-role inbox

claims.jsonsoft-locks so agents don't collide

DESCRIPTION

SYNOPSIS

EXAMPLES

FILES

SEE ALSO