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.
allowed-tools
- Bash1 skill
- Edit1 skill
- Glob1 skill
- Grep1 skill
- Read1 skill
- Write1 skill
scripts
- swarm
- scripts/swarm.mjs
plugin.json
- name
- swarm
- version
- 1.0.0
- description
- 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.
- author
- Marco Pesanihttps://github.com/marcopesani
- license
- MIT
- extensions
- com.openai
plugin.json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "swarm",
"version": "1.0.0",
"description": "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.",
"author": {
"name": "Marco Pesani",
"url": "https://github.com/marcopesani"
},
"homepage": "https://github.com/marcopesani/swarm-skill",
"repository": "https://github.com/marcopesani/swarm-skill",
"license": "MIT",
"keywords": [
"agent-skills",
"claude-code",
"codex",
"skills",
"swarm",
"multi-agent",
"openrouter"
],
"extensions": {
"com.openai": {
"requires_local_executor": true,
"interface": {
"displayName": "Swarm",
"shortDescription": "Lead a team of cheap AI agents",
"longDescription": "Swarm turns your agent into the lead of a team of cheap pi coding agents running OpenRouter models. The lead splits a large task (a migration, many files, many tests) into subtasks that do not collide, starts each worker in its own git worktree, coordinates through a shared SQLite database, audits every command the workers ran, and merges only work that builds and passes the tests.\n\nFor developers with big, splittable work where one strong agent doing everything costs too much.\n\nLimitations: it runs only when asked by name; it needs an OpenRouter API key with a credit limit and starts no workers under $5 left; workers run shell commands on the local machine without a sandbox, so use a disposable machine or VM; it needs a local executor (Codex CLI, the desktop app, Claude Code or pi) and does not run in web chat.",
"developerName": "Marco Pesani",
"category": "Developer Tools",
"capabilities": [
"Read",
"Write"
],
"websiteURL": "https://github.com/marcopesani/swarm-skill",
"supportURL": "https://github.com/marcopesani/swarm-skill/issues",
"privacyPolicyURL": "https://github.com/marcopesani/swarm-skill/blob/main/PRIVACY.md",
"termsOfServiceURL": "https://github.com/marcopesani/swarm-skill/blob/main/LICENSE",
"defaultPrompt": [
"Use $swarm to split this migration across a team of pi workers.",
"Use $swarm to fix every failing test in this repo with a small team."
],
"brandColor": "#EA580C",
"composerIcon": "./assets/icon.png",
"logo": "./assets/icon.png"
}
}
}
}
What else this package ships
These files come with the package and this site does not publish them. They are listed so you know what is there before you install it.
- swarm.mjs
- openai.yaml
- 2other files
- icon.png
Client extensions
Data this package carries for particular clients. The directory lists the clients named and never reads what is addressed to them.
- com.openai