Self-hosted control plane for agent runs

Runyard

A capability operating system you run on your own box. Agents discover work through MCP, runners execute on a VPS or laptop, and the Hub keeps the durable record of approvals, logs, artifacts, skills, agents, and knowledge.

Open the operations console Read setup docs /llms.txt for agents

Backwards-compatible CLI & MCP bin: smithers-hub, smithers-hub-mcp, smithers-hub-runner.

Runyard ships as a Node + SQLite app. No external services required to start. Replace hub.example.com with whatever domain you serve from.

1 Install

git clone https://github.com/yolo-maxi/runyard
cd runyard
pnpm install
pnpm build:vendor

2 Run locally

pnpm start
# server prints data/bootstrap-token.txt on first boot
open http://127.0.0.1:43117/app

First-start writes data/bootstrap-token.txt. Paste it on the login screen.

3 Connect every agent

bash <(curl -fsSL https://hub.example.com/install.sh)
smithers-hub mcp install --all

Auto-detects Claude Code/Desktop, Codex, Cursor, Windsurf, Gemini, VS Code.

4 Bring runners online

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

Add more on VPSes, workstations, or laptops; the Hub matches runs by tag.

Private Hub

One Hub per org, behind your own domain, with SQLite and artifacts under a backed-up data directory.

Runner Pool

Put build and browser work on worker VPSes or laptops. The Hub owns the queue; runners poll over HTTPS.

Public Docs, Private Ops

Serve docs statically, keep the operations console, API, MCP, runner tokens, SQLite, and artifacts private.

Capability Catalog

Agents see a clean menu of team-defined actions with input/output schemas, required runner tags, skills, and approval policy.

Local and Remote Runners

Run work on a VPS, laptop, or workstation; the Hub keeps the durable record and the runners stay disposable.

Unified Approvals

Approve through Web, API, CLI, Telegram, or MCP without re-implementing workflow gates per surface.

Shared Company Memory

Editable skills, agents, and knowledge entries become reusable infrastructure rather than scattered prompts.

Open agent surface

Stable HTTP API, /openapi.json, /llms.txt, and an MCP server keep agents and humans on the same surface.

Private by default

Bearer-token auth, per-deployment data dir, no SaaS dependency. Bring your own domain and TLS terminator.

Runyard is the public name for the project formerly called Smithers Hub. Package, bin, and env names keep the smithers-hub prefix so existing deployments and tokens keep working.