agentcoord

Vendor-neutral coordination daemon for multiple AI CLI agents (Claude Code, Codex, Aider) working on the same repository.

Prevents file conflicts, tracks task state, and lets Claude plan while Codex workers execute in parallel.

Install

npm install -g agentcoord

Quick start

# In your project directory
agentcoord init    # sets up .agentcoord.json, .mcp.json, and registers daemon as a background service
agentcoord start   # start the coordination daemon

Then restart Claude Code — it will automatically connect via MCP and gain coordination tools.

How it works

Claude Code (planner)
  → breaks task into file-scoped subtasks
  → spawns Codex workers via /spawn-workers

Codex workers (executors)
  → each claims a file lease before editing
  → reports progress to daemon via HTTP
  → releases lease when done

Daemon (coordinator)
  → runs in background, always on
  → enforces file leases — no two agents can edit the same file
  → tracks task state in SQLite
  → crash recovery via lease timeouts

Claude Code integration

agentcoord init writes the MCP server config to .mcp.json automatically. Claude Code gains these tools:

| Tool | Description | |------|-------------| | claim_files | Acquire a file lease before editing | | release_files | Release a lease when done | | prewrite_check | Check if files are free before writing | | get_task_plan | Get current task state | | spawn_worker | Spawn a Codex worker for a task | | worker_status | See what all workers are doing |

Codex worker HTTP API

Codex workers report back via HTTP on localhost:8080:

| Endpoint | Description | |----------|-------------| | POST /task/claim | Claim files | | POST /task/heartbeat | Keep lease alive | | POST /task/prewrite | Check files before writing | | POST /task/commit | Mark task done, release files | | POST /task/release | Release files early |

CLI

agentcoord init     # initialize in current project
agentcoord start    # start the daemon
agentcoord status   # show active leases and tasks
agentcoord mcp      # start MCP server (called by Claude Code automatically)

Requirements

• Node.js 18+
• macOS (Linux support coming)