swarmspace

Leaderless agent swarms that coordinate through the filesystem, split work by claim, and audit before close.

A multi-repo workspace toolkit for parallel agent execution. Spawns N peer agents (Claude Code or GitHub Copilot CLI) that coordinate via shared memo + journal, split work by atomic claims, and audit each other before close. Ships with three protocols: read-only investigation, executor refactor, and divergent-creative tournament.

Install

Claude Code plugin:

/plugin marketplace add AndurilCode/swarmspace
/plugin install swarmspace

Copilot CLI plugin:

copilot plugin marketplace add AndurilCode/swarmspace
copilot plugin install swarmspace

Plugin install auto-bootstraps on first session: deploys ws to ~/.local/bin/, recipes to ~/.config/just/, and scripts to ~/.config/swarmspace/. Ensure ~/.local/bin is on your $PATH.

Manual (no host required, command-line only):

git clone https://github.com/AndurilCode/swarmspace
cd swarmspace
./bootstrap.sh

Usage

ws                                                    # list all recipes
ws swarm <dir> 3 "<task>"                             # parallel executor swarm
ws investigate <dir> 3 --goal "<q>" --scope "<r>"     # read-only investigation
ws swarm <dir> 3 --agent tournament "<creative task>" # divergent candidates, judged

Run ws -l for all recipes. See skills/orchestrating-swarms/SKILL.md and agents/*.md for protocol details.

Requirements

• bash 3.2+ · jq · just (auto-installed)
• claude CLI or gh (with Copilot) — at least one as the backend

License

MIT