agent-sync plugin
Coordination layer for multi-agent repositories. Gives task-pipeline runs leases with a TTL, race-free ID reservation, a cross-repo signal feed, an append-only run journal and a machine-generated read-only board. A lease is decided by a primitive that genuinely has compare-and-swap — an atomic file create on one machine, a pushed git ref across machines — never by the knowledge base, which loses concurrent writes; the store carries the record and the ID allocation, which is positional over the merged log. The knowledge backend is a pluggable adapter (Outline, filesystem) declaring its own capabilities and degrading out loud. Ships Claude Code hooks that deny edits to guarded registry files without a live lease.
How to install the agent-sync plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add ssheleg/agent-sync
/plugin install agent-sync@agent-syncWhat's inside agent-sync
6 parts read from the plugin's own files.
Commands 1
Run as /agent-sync:name- /agent-sync:agent-sync[init|status|check|acquire <KEY>|release <KEY>|reserve <REG>|residue|board|merge
Coordinate concurrent agents — initialise the shared knowledge store, check status, take a task, reserve an id, or regenerate the board.
Skills 1
Claude loads it when the task matches- agent-sync
Use when several agents share a repo: claim a task, see who works on it, reserve an id, sync the board, set up coordination. RU: возьми задачу, кто сейчас делает, зарезервируй id, обнови доску. Not for solo work or an unconfigured repo: 'no coordination' / «без координации».
Hooks 4
Runs on these events- PostToolUsecommand
*
- PreToolUsecommand
Edit|Write|MultiEdit|NotebookEdit|apply_patch, Bash
- SessionEndcommand
No description in the file.
- SessionStartcommand
startup|resume|clear
Using agent-sync in Claude Code
Type a command in a Claude Code session:
/agent-sync:agent-sync [init|status|check|acquire <KEY>|release <KEY>|reserve <REG>|residue|board|mergeSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update agent-sync@agent-sync
- Refresh the marketplace
- /plugin marketplace update agent-sync
- Turn it off for now
- /plugin disable agent-sync@agent-sync
- Remove it
- /plugin uninstall agent-sync@agent-sync
Skills in agent-sync
- agent-syncssheleg/agent-sync
Use when several agents share a repo: claim a task, see who works on it, reserve an id, sync the board, set up coordination. RU: возьми задачу, кто сейчас делает, зарезервируй id, обнови доску. Not for solo work or an unconfigured repo: 'no coordination' / «без координации».
16 files5stars
agent-sync plugin questions
How do I install the agent-sync plugin?
In Claude Code run /plugin marketplace add ssheleg/agent-sync, then /plugin install agent-sync@agent-sync.
What does the agent-sync plugin include?
agent-sync bundles 1 command, 1 skill, hooks.
What commands does the agent-sync plugin add?
It adds /agent-sync:agent-sync. Run them in Claude Code with the plugin prefix, for example /agent-sync:agent-sync.
How do I update or remove the agent-sync plugin?
Update it with claude plugin update agent-sync@agent-sync in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall agent-sync@agent-sync.
What license is the agent-sync plugin under?
MIT, as stated in the plugin's manifest.