Clanker

Claude Code plugin + stdio MCP server for running external coding agents as Claude-owned background tasks.

Clanker exposes these slash commands:

Command	Backend
/clanker:codex <task>	Codex ACP
/clanker:grok <task>	Grok ACP
/clanker:glm <task>	Opencode with GLM
/clanker:deepseek <task>	Opencode with DeepSeek
/clanker:kimi <task>	Opencode with Kimi
/clanker:free <task>	Opencode free model
/clanker:oc <provider/model> <task>	Advanced Opencode model override

Default mode is background: the Claude Agent task owns the visible bottom task row, while the MCP server owns the ACP backend process. Use --wait to run foreground.

Layout

.
├── .claude-plugin/marketplace.json
├── plugin/
│   ├── .claude-plugin/plugin.json
│   ├── .mcp.json
│   ├── agents/
│   ├── commands/
│   └── dist/clanker-mcp.mjs
├── src/
├── test/
├── scripts/
└── package.json

Install

claude plugin marketplace add /path/to/ClankerHouse
claude plugin install clanker@clanker

Then restart Claude Code or run /reload-plugins.

The active Claude config should point here:

"enabledPlugins": {
  "clanker@clanker": true
},
"extraKnownMarketplaces": {
  "clanker": {
    "source": {
      "source": "directory",
      "path": "/path/to/ClankerHouse"
    }
  }
}

Development

npm ci
npm run bundle
npm test
npm run typecheck

npm run bundle writes plugin/dist/clanker-mcp.mjs, the self-contained server bundle Claude loads from its plugin cache.

Runtime Config

Env	Default	Meaning
CLANKER_STALL_THRESHOLD_MS	300000	Silence before a running turn is flagged as suspected stalled.
CLANKER_TURN_TIMEOUT_MS	2700000	Hard per-turn ceiling before the subprocess is killed and the turn becomes error.
CLANKER_HANDSHAKE_TIMEOUT_MS	30000	ACP initialize + session/new timeout.
CLANKER_SESSION_TTL_MS	600000	Idle session TTL before reaping.
CLANKER_WAIT_DEFAULT_MS / CLANKER_WAIT_MAX_MS	30000 / 55000	clanker_wait long-poll default and cap.
CLANKER_PROGRESS_EXPERIMENTAL	unset	=1 enables MCP progress notifications.
CLANKER_MCP_BASE_REPO	server cwd	Base repo for managed worktrees.
CLANKER_RUNS_ROOT / CLANKER_WORKTREES_ROOT	~/.cache/clanker/{runs,worktrees}	Artifact and managed worktree roots.