⚡ AgentSync

A multi-agent collaboration hub for AI coding teams. Many humans and AI agents work on one repo from a shared plan — with file-scope claims, live chat, and conflict warnings before anyone pushes. So fast agents never collide.

Coding agents (Claude, Codex, Kimi…) generate code so fast that a 4-person team can produce a day's worth of conflicts in an hour. AgentSync is the starter kit you drop in before the work starts: everyone — every human and every agent — joins one shared hub that shows who's online, what the plan is, who has claimed which files, and warns the moment two people are about to touch the same code.

git owns the code. AgentSync owns the awareness. It never blocks git — it makes collisions visible while they're still cheap to avoid.

Why this exists

Existing "parallel agent" tools (Vibe Kanban, Conductor, ccswarm, opencode-ensemble) are excellent but single-user, single-machine — one dev orchestrating many agents on one box. AgentSync is built for the case none of them cover: many people, many machines, many heterogeneous agents, coordinating in real time.

Related MCP server: ACDP

What you get

• One hub, everyone dials in. Star topology, not a mesh. No manual peering.

• Identity & roster. Each participant is person.machine.agent (deepak.mac-a.claude, naman.laptop.codex). Live presence on a dashboard.

• Plan-first gate. No task can be claimed until a plan is approved.

• Task board with file-scope locks. Claiming a task locks its file globs; overlapping claims are warned instantly.

• Pre-push announce. A git hook posts your diff to the team chat and warns if it overlaps someone's active work — so you know what you're pushing first.

• Shared chat over WebSocket, with a live dashboard timeline.

• Agent-native via MCP. Claude/Codex call claim_task, check_conflicts, post_message themselves — they participate in the chat autonomously.

• Event-sourced. Every action is an append-only NDJSON log → durable, replayable, and it is the activity feed.

Only hard dependencies: Node ≥ 22 and git (which every participant already has).

Quickstart

1. One person starts the hub

npx agentsync hub
#   ⚡ AgentSync hub is live
#   Dashboard   http://localhost:7777  ·  http://192.168.1.20:7777
#   Hub URL     http://192.168.1.20:7777
#   Teammates join with:  npx agentsync join http://192.168.1.20:7777

Open the Dashboard URL. For a distributed team, deploy the same command on any host (VPS/container) and put its URL in agentsync.config.yaml → hub_url.

2. Everyone else joins from their clone

npx agentsync join http://192.168.1.20:7777
#   Who are you?
#   Your name          > deepak
#   This machine label > mac-a
#   Agent (human/claude/codex/kimi) [human] > claude
#   Role (orchestrator/coder/frontend/backend/reviewer/planner) [coder] > backend
#   ✓ Joined as deepak.mac-a.claude (backend)

join writes your identity, auto-configures your agent's MCP (.mcp.json for Claude Code; prints the Codex config.toml snippet), and installs the git hooks. That's it.

3. Agents self-onboard

Your Claude/Codex session reads AGENTS.md, asks "who am I working as?", calls agentsync_register, and then works through get_plan → claim_task → check_conflicts on its own. No babysitting.

The four deployment scenarios

The git flow it encourages

claim task ─▶ worktree off latest main, branch person/agent/slug
   work    ─▶ small, frequent commits (pre-commit blocks .env / keys / secrets)
   sync    ─▶ rebase on main when it advances (conflicts stay tiny)
   push    ─▶ pre-push announces the diff + warns on overlap  →  YOUR branch only
   done    ─▶ open PR → CI → auto-merge on green.  main is never pushed directly.

Try the live demo

npx agentsync hub                 # terminal 1
AGENTSYNC_KEEP=1 npm run demo     # terminal 2 — 3 simulated agents plan, claim, collide

Watch the dashboard: three agents come online, the plan is approved, tasks get claimed, and an overlap warning fires when one agent claims files another already owns.

MCP tools agents get

agentsync_register · get_plan · set_plan · approve_plan · list_members · list_tasks · add_task · claim_task · release_task · complete_task · check_conflicts · announce_edit · post_message

Configuration — agentsync.config.yaml

Roles, hot_files (extra-warned shared files), protected_paths (commit deny-list), and the branch template all live here, committed as the team's shared rules of engagement.

Architecture

apps            src/hub/      HTTP + WebSocket + event-sourced store (NDJSON)
                src/mcp/      MCP stdio server — the agent-facing tools
                src/cli/      hub · join · status · git-hook backends
                src/dashboard/ single-file live UI (roster · chat · board · timeline)
                src/lib/      shared hub client (Node global WebSocket)
hooks/          pre-push (announce+overlap) · pre-commit (protected-path guard)

Roadmap

• Git-branch transport for the no-infra fallback

• Auto-spawn per-task worktrees from the CLI

• PR/CI status surfaced on the board

• Auth on the hub (currently a shared token)

License

MIT