hive

Agent Hive

Plan first. Execute with trust. Context persists.

Agent Hive is a workflow layer that sits on top of your AI coding tool. It imposes just enough structure to make multi-agent, multi-step work traceable and recoverable — without taking ownership of your editor, your model, or your coding style.

---

Demo

https://github.com/user-attachments/assets/6290b435-1566-46b4-ac98-0420ed321204

---

Why Hive

Raw agentic coding has a consistent failure mode: agents spray changes across a codebase, sessions lose context, parallel workers collide, and nobody can reconstruct what happened. Hive fixes this with a small, strict loop:

You describe the work
    ↓
Hive discovers, asks, builds plan.md
    ↓
You review and approve   ← human gate
    ↓
Workers execute tasks in isolated git worktrees (batched parallel)
    ↓
Results merge. plan/spec/report live in .hive/ forever.

Without Hive	With Hive
Agent touches 40 files, half break	Tasks run in isolated worktrees — discard any worker
New session starts from zero	Feature state persists in .hive/features/<name>/
Parallel agents collide, duplicate	Explicit batches with dependency ordering
"What happened here?"	plan.md, spec.md, report.md per task
Scope creep mid-execution	Human approval gate before any code change

---

Choose Your Platform

Platform	Hive role	Best for
Claude Code	Full runtime (plugin + MCP)	Claude Code CLI users
OpenCode	Full runtime (plugin)	OpenCode CLI users — most feature-complete
VS Code	Companion UI (review + status)	Visual review alongside a CLI runtime

The VS Code extension is not a runtime. It visualises the .hive/ state written by Claude Code or OpenCode and lets you approve plans without leaving the editor.

---

Claude Code

The Claude Code plugin ships three Hive agents (hive, forager, hygienic), a /hive slash command, 11 on-demand skills, a SessionStart hook, and spawns the @tctinh/agent-hive-mcp MCP server as a sidecar.

Install — Recommended: plugin marketplace

# inside Claude Code
/plugin marketplace add tctinh/agent-hive
/plugin install hive@agent-hive

The marketplace definition lives at .claude-plugin/marketplace.json and points at packages/claude-code-hive. The MCP runtime is loaded via node ./scripts/launch-hive-mcp.mjs, which resolves @tctinh/agent-hive-mcp from a node_modules tree. For marketplace installs, install the MCP runtime once so the launcher can resolve it:

npm install -g @tctinh/agent-hive-mcp

Install — Alternative: self-contained npm install

Useful when you prefer a single project-local dependency tree and don't want a global install:

mkdir -p .agent-hive/claude && cd .agent-hive/claude
npm init -y
npm install claude-code-hive @tctinh/agent-hive-mcp

Then register the plugin by pointing Claude Code at .agent-hive/claude/node_modules/claude-code-hive/.claude-plugin/plugin.json.

Start

/hive add user authentication

/hive is the only entry point you need — it creates a feature, runs discovery, writes the plan, waits for approval, and dispatches workers.

What you get