Agent Beacon

🛰️ Beacon

Real-time presence & collision-avoidance for parallel AI coding agents

Run two, five, ten Claude Code sessions on the same repo at once — and **never let them clobber each other's work again.**

English · 简体中文

[](https://www.npmjs.com/package/beacon-agents) [](LICENSE) [](https://nodejs.org) [](package.json) [](https://docs.claude.com/en/docs/claude-code) [](CONTRIBUTING.md)

The problem

Running multiple AI coding agents in parallel is the new normal — one session refactors the API, another writes tests, a third bumps configs. It's a huge speedup, until two of them edit the same file, or one runs `git checkout` / `git stash` and silently yanks the files out from under the others. You discover the collision only *after* work is lost.

Agents are flying blind. **They can't see each other.**

What Beacon does

Beacon is a tiny local service that gives every agent a shared, real-time picture of *who is touching what* — and warns them the instant two of them overlap.

• 👀 Mutual awareness — every session reports what it's editing; others can see it live.
• ⚡ Collision warnings, in-context — when an agent is about to edit a file another agent is already in, Beacon injects a one-line heads-up into that agent's own context, before the edit.
• 🔪 Guards risky shared-tree ops — `che