marcopesani/swarm
v1.0.0MIT
Lead a team of cheap pi workers (OpenRouter models) on a big, splittable task: you plan, assign and judge, workers build in their own git worktrees, a shared SQLite database is the only channel, and only work that builds and passes tests gets merged.
Changelog
All notable changes to this project are documented here. The format follows Keep a Changelog, and versions follow Semantic Versioning.
Unreleased
1.0.0 - 2026-11-11
Added
- A standalone, MIT-licensed repository for the swarm skill. Install it with
npx skills(skills.sh), the Claude Code plugin marketplace, the Codex plugin marketplace, orpi install. - Release assets:
swarm-skill.zip, which passes the strict Agent Skills spec (claude.ai, Cowork, Claude Skills API, or unzipped into any agent's skills folder), andswarm-plugin.zip, which carries the Agent Plugins, Claude Code and Codex manifests (OpenAI plugin portal, Codex desktop,claude --plugin-url). Both zips are deterministic, and the release lists them inSHA256SUMSwith build provenance. - Codex:
agents/openai.yaml, withallow_implicit_invocation: false. The plugin also setsrequires_local_executor. swarm skillssearches the Agent Skills locations (.agents/skills,~/.agents/skills,~/.config/agents/skills), pi's and Codex's folders, and project folders from cwd up to the repo root. It follows the symlinksnpx skillscreates, lists each skill once, and names plugin skills from Agent Plugins and Codex manifests too.swarm auditflags access to~/.codex/.- Unit and integration tests for the workbench, with a stub pi for
spawn. A validator for the spec, every manifest and OpenAI's listing limits. One generator for all manifests.
Changed
disable-model-invocationis now a top-levelSKILL.mdfield, so Claude Code and pi honour it. Asmetadata.disable-model-invocationit had no effect.allowed-toolsis space-separated, as the spec asks.schema.sqlmoved toassets/.SKILL.mdno longer assumes one company's stack. Worktree setup, network hosts and lead-only work (specs, the live app, the final review) are now written for any repo. The concrete pnpm + submodules + in-memory MongoDB setup moved toreferences/worktree-setup.mdas a worked example.