Agent Herder

MCP control center for coding agents.

Monitor, inspect, search, and coordinate AI coding sessions from one MCP server: OpenCode, Claude Code, Codex CLI, and Qoder.

Русский · 简体中文

Start in 30 seconds

Run it without cloning a repository:

npx -y agent-herder

Add the same command to any MCP client:

{
  "mcpServers": {
    "agent-herder": {
      "command": "npx",
      "args": ["-y", "agent-herder"]
    }
  }
}

Start the harness you want to observe first. For OpenCode, that means:

opencode serve

Related MCP server: all-agents-mcp

What it does

Monitor, inspect, and coordinate. Agent Herder gives your MCP client one control plane for coding-agent sessions that normally live in separate tools.

• See running, idle, stopped, and waiting sessions in one list.

• Find a session's parent and children without guessing IDs.

• Read the latest messages or search one transcript with bounded context.

• Send, resume, stop, steer, or recover sessions where the harness supports it.

• Review permissions, switch models, inspect worktrees, and summarize sessions.

Typical request:

Find the parent of this session, list its children, then show the last five messages from the child that is currently working on the bug.

Why people use it

Use Agent Herder when you need an MCP server for OpenCode, a Claude Code session manager, Codex CLI transcript search, or one dashboard for several AI coding agents. It is especially useful for parent/child agent workflows, parallel coding tasks, bounded context, and session recovery.

Supported harnesses

Core MCP tools

get_transcript accepts a session ID, an optional number of latest messages, and an optional search prompt. It returns only the useful slice instead of loading an entire conversation into context.

Requirements

• Node.js 22+ and npm.

• At least one supported harness installed and available in PATH.

• OPENAI_API_KEY for Codex when the Codex app-server requires it.

Configuration

The common switches are:

Example for Qoder:

export ENABLE_QODER=true
export QODER_CWD=/path/to/project
npx -y agent-herder

Develop locally

npm ci
npm test
npm run build
npm run inspect

The local stdio entrypoint is dist/index.js.

The optional web UI runs on loopback:

export AGENT_HERDER_WEB_PORT=8787
npm start

Open http://127.0.0.1:8787/. For a persistent ACP profile, set ACP_AGENT_COMMAND, ACP_AGENT_ARGS as a JSON array, and ACP_AGENT_PROFILE before starting the server.

FAQ

Does Agent Herder replace my coding agent? No. It connects your MCP client to the sessions owned by OpenCode, Claude Code, Codex, or Qoder.

Does get_transcript load everything? No. Ask for the latest N messages or search for a prompt; the result is bounded for practical agent context.

Can I use only one harness? Yes. Disable adapters you do not run with the ENABLE_* variables.

License

MIT