Agent Coord

agent-coord

[](https://github.com/v2matosevic/agent-coord/actions/workflows/ci.yml) [](./LICENSE) [](https://nodejs.org) 

**A machine-wide coordination layer so multiple AI coding agents running at once don't step on each other.** Shared presence, file locks, a universal git commit guard, agent-to-agent messaging, and duplicate-work detection — across every terminal, window, and repo on your machine.


Built on Node's built-in `node:sqlite` (WAL). The hooks and CLI are **zero-dependency**; only the MCP server pulls one package (`@modelcontextprotocol/sdk`). No native build, no daemon, no SPOF — it fails *open but loud*, so a glitch never freezes your work.

---

Why

Every AI coding agent is an island: a Claude Code session, a Codex session, and a Cursor agent each see only their own context and their own working tree. Run a few at once on one repo — or sharing one dev port / DB / deploy — and they edit the same file simultaneously, duplicate each other's work, make contradictory decisions, and collide on shared singletons. That's a distributed-systems failure with **no coordination primitive**. This adds one.

---

Install

Option A — let your coding agent do it (recommended)

Clone the repo, open it in your agent (Claude Code, Codex, Cursor, …), and paste:

**Read `AGENTS.md` in this repo and set up agent-coord for me: install it, run the health check, and tell me what's live and what I need to do next.**

The agent follows the [`AGENTS.md`](./AGENTS.md) runbook — installs,