AgentHub

AgentHub is a local MCP agent-team runtime for coding projects. An external orchestrator (Cursor, Codex, Claude, a custom MCP client, etc.) spawns named workers, delegates scoped tasks, waits for results, and resumes sessions. The human watches a read-only board; they do not drive the team from provider tabs.

North star: docs/MUST-DO-DIRECTION.md

What you get

Implementation: agenthub-daemon (TypeScript) + agenthub-tui (Rust).

Related MCP server: Orchestration MCP

Provider support (V1)

Details: docs/PROVIDER-SUPPORT-MATRIX.md
Per-provider CLI evidence and orchestrator notes: docs/PROVIDER-KNOWLEDGE.md

Experimental providers: Grok and OpenCode may spawn and delegate, but AgentHub does not claim durable resume (runtimeCanResume: false). Prefer Codex or Cursor when restart-safe work matters.

V1 release status

Core V1 is release-ready when the local release gates are green: build, daemon tests, TUI tests, package validation, packed install smoke, and the final dogfood transcript.

• Current status: docs/STATUS.md

• Final dogfood: docs/V1-DOGFOOD-2026-06-06.md

• Release notes: docs/RELEASE-NOTES-V1.md

Install

Requires Node.js 20+. No Rust/MSVC at install time.

Installer channel (irm / curl)

The live stoyanco.com channel currently publishes the Windows x64 artifact.

irm https://stoyanco.com/agenthub/install.ps1 | iex

macOS/Linux use the same channel after their platform artifacts are built and uploaded:

curl -fsSL https://stoyanco.com/agenthub/install.sh | bash

Maintainer build/upload flow: docs/INSTALLER-CHANNEL.md

npm package

npm install -g @agenthub-mcp/cli
agenthub doctor
agenthub init .
agenthub mcp

Connect your orchestrator to agenthub mcp (stdio MCP). Typical flow:

create_session → get_session_state → spawn_worker → delegate_to_worker
→ wait_for / get_updates → recover_session (after daemon restart)

Also: agenthub_list_sessions, agenthub_get_runtime_manifest (includes providerCapabilities + knowledge doc paths).

Full orchestrator guide: docs/AGENTHUB-SKILL.md

Read-only board

agenthub launch .

Starts the daemon and TUI board (worker tabs, ops queue, settings). Default UX is read-only observation — orchestration stays in MCP.

• Requires a prebuilt TUI binary when installed from npm (vendor/tui/<platform>-<arch>/).

• Legacy / debug (not V1 product path): provider-first tabs (/debug on), Home slash orchestration, F2/F3 writer lock, conductor MCP tools. See docs/LEGACY-RETIREMENT.md.

Dev checkout

git clone <repo-url>
cd agenthub
npm install
npm run build
agenthub doctor
agenthub mcp

Cursor MCP (dev checkout)

This repo ships .cursor/mcp.json so Cursor loads AgentHub automatically for this workspace (bin/agenthub.js mcp with AGENTHUB_PROJECT=${workspaceFolder}). After npm run build, reload MCP servers in Cursor settings.

Smoke test (mock adapters, no provider credits):

npm run smoke:mcp

Windows TUI builds need MSVC (npm run build:tui). See docs/RELEASE-CHECKLIST.md.

HTTP API (optional): agenthub daemon on port 4367.

Docs map

Adapter overrides (optional)

$env:AGENTHUB_CODEX_ARGS="-m gpt-5.4-mini"
$env:AGENTHUB_CURSOR_ARGS="--model composer-2.5"
$env:AGENTHUB_GROK_ARGS="-m grok-build-0.1"
$env:AGENTHUB_OPENCODE_ARGS="-m opencode-go/kimi-k2.6"

See docs/CLI-FLAGS.md and provider knowledge files for launch templates and resume behavior.