AgentCollision AgentCollision Docs

Quickstart

Install AgentCollision, enable the hook in Claude Code, and see it catching conflicts in under a minute.

1. Install the daemon

AgentCollision runs as a single Go binary. Pick your platform:

# macOS (Homebrew)
brew install agentcollision

# Linux / macOS (curl)
curl -fsSL https://agentcollision.com/install.sh | sh

# Windows (PowerShell)
iwr https://agentcollision.com/install.ps1 -useb | iex

Verify the install worked:

ac --version

2. Initialize

Run once to install hooks into your AI coding tools and start the daemon:

ac init

This is idempotent. It detects which tools you have installed (Claude Code, Cursor, Cline, Windsurf) and wires up each one's PreToolUse mechanism.

What just happened. A daemon is running in the background on localhost:7777. When any AI tool tries to edit a file, it calls the daemon first. The daemon either grants a short-lived lease ("you own this file for 30 minutes, go ahead") or blocks the edit ("someone else is editing this file right now, wait").

3. See it working

Open two Claude Code sessions in the same repo. In each one, ask Claude to edit the same file. The second session's edit will be blocked synchronously, with a reason like:

Edit denied: file auth.ts is held by claude-code/abc12345 (expires in 28m)

Open the local dashboard to watch what's happening in real time:

ac dashboard

You'll see every active lease, every chat currently editing files, and a live event stream as agents acquire and release coordination.

4. Set up a team (optional)

Coordination works great on a single machine. If you want Alice on her MacBook and Bob on his Linux box to coordinate across machines, create a team:

ac team create "Your Team Name"

You'll get an invite code. Share it with teammates:

ac team join ABC123

That's it. Both machines now sync lease state through the hosted coordinator. Open the team dashboard from anywhere:

ac team dashboard
Privacy. File paths are HMAC-hashed before leaving your machine. The coordinator never sees your actual code or directory layout. See Privacy model.

Next steps