# multi-repo-swarm

multi-repo-swarm coordinates AI swarms across multiple repositories with the GitHub CLI and ruv-swarm. Useful for cross-project updates.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/multi-repo-swarm.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/multi-repo-swarm

## What it 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.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/multi-repo-swarm.md` — Call it with /multi-repo-swarm. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/multi-repo-swarm.md` — Call it with /prompts:multi-repo-swarm. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/multi-repo-swarm.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/multi-repo-swarm.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/multi-repo-swarm.md

## When to use it
- 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
- 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

## Similar
- [github-multi-repo](https://affpapa.org/en/nevibecode/skills/github-multi-repo.md) — skill · 1200 installs
- [oss-contributor-swarm](https://affpapa.org/en/nevibecode/skills/oss-contributor-swarm.md) — skill · ★ 138 repo stars
- [repo-init](https://affpapa.org/en/nevibecode/commands/repo-init.md) — command · ★ 763 repo stars
- [multi-repo-git-ops](https://affpapa.org/en/nevibecode/skills/multi-repo-git-ops.md) — skill · 104 installs
- [ax-repo](https://affpapa.org/en/nevibecode/skills/ax-repo.md) — skill · ★ 124 repo stars
- [swarm](https://affpapa.org/en/nevibecode/skills/backnotprop-swarm.md) — skill · 10300 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
