Install

pnpm install
PORT=43117 BASE_URL=https://hub.repo.box pnpm start

Authentication

Smithers Hub uses access tokens. The first server start creates data/bootstrap-token.txt. Use that token for Web login, CLI, MCP, API, and runners.

CLI

smithers-hub login --url https://hub.repo.box --token shub_...
smithers-hub capabilities
smithers-hub run prepare-spec --input '{"goal":"Write a launch spec"}'
smithers-hub runs
smithers-hub approvals
smithers-hub approve appr_...

MCP

{
  "command": "smithers-hub-mcp",
  "env": {
    "SMITHERS_HUB_URL": "https://hub.repo.box",
    "SMITHERS_HUB_TOKEN": "shub_..."
  }
}

Runner

SMITHERS_HUB_URL=https://hub.repo.box \
SMITHERS_HUB_TOKEN=shub_... \
SMITHERS_RUNNER_TAGS=linux,node,git,shell,web,smithers \
smithers-hub-runner

Agent Discovery

/llms.txt and /openapi.json describe the agent-facing surface.