multi-repo-swarm — Claude Code command: what it does, how to install
multi-repo-swarm coordinates AI swarms across multiple repositories with the GitHub CLI and ruv-swarm. Useful for cross-project updates.
no license ★ 850 updated 2026-10-26
.claude/commands/multi-repo-swarm.mdWhat multi-repo-swarm does
This command sets up synchronized actions across an entire GitHub organization. It queries repositories using the gh CLI, parses dependency trees via jq, and organizes repos into an orchestration network. Projects can take on distinct roles such as UI, API, or shared library, coordinated via a designated hierarchy and external memory.
Using npx ruv-swarm, the tool clones matching repositories into temporary folders, executes task scripts, runs local test suites, and opens linked pull requests. It handles batch dependency upgrades, large API migrations, and security vulnerability patching across repos.
Execution relies strictly on Node.js and an authenticated gh CLI session. Without proper organization permissions in GitHub CLI, automated discovery and pull request creation will fail.
What it helps with
- Bump a shared dependency across multiple organizational repositories
- Discover related codebases based on language or package dependencies
- Generate linked pull requests across frontend and backend services
- Apply organization-wide API refactoring patterns automatically
Example prompts for the agent
- Run multi-repo-swarm to plan a synchronized TypeScript update across our microservices
- Discover all repos depending on the shared library and open tracking pull requests
- Execute security patches across all services and link the resulting PRs
How to install multi-repo-swarm
Manually: put the files in place
.claude/commands/multi-repo-swarm.mdCall it with /multi-repo-swarm. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/multi-repo-swarm.mdCall it with /prompts:multi-repo-swarm. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/multi-repo-swarm.prompt.mdManually: put the files in place
.gemini/commands/multi-repo-swarm.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about multi-repo-swarm
How to install multi-repo-swarm in Claude Code?
Place the command specification file into .claude/commands/multi-repo-swarm.md inside your repository.
What does multi-repo-swarm do?
It orchestrates agent operations across multiple repositories, running updates and managing interdependent GitHub pull requests.
What dependencies are required to run it?
You need an authenticated GitHub CLI installation (gh), jq, and Node.js with npx access to run the orchestration packages.