# multi-repo-swarm

multi-repo-swarm — a subagent for Claude Code that orchestrates multiple agents across your organization's repositories. Runs synchronized tasks, manages dependencies, and links pull requests between projects.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 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/agents/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/agents/multi-repo-swarm

## What it does

Sets up a swarm with hierarchical topology where each repository gets a role—UI, API, library—and its own set of specialized agents. Synchronizes operations through GitHub CLI: discovers repos by language and dependencies, applies the same changes everywhere (dependency updates, refactoring, security patches), and creates linked pull requests.

Uses swarm_init, agent_spawn, task_orchestrate tools for lifecycle management, plus github_repo_analyze, github_pr_manage, github_sync_coord to work with repositories. Requires GitHub CLI authentication—`gh auth status` is verified on startup. Configure via `.swarm/multi-repo.yml` that describes repos, their roles, interdependencies, and sync strategy.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/multi-repo-swarm.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/multi-repo-swarm.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/multi-repo-swarm.md` — Cursor also reads .claude/agents/

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/agents/github/multi-repo-swarm.md

## When to use it
- update a single dependency across all microservices simultaneously
- run large-scale refactoring coordinated between frontend and backend projects
- deploy a security patch to all affected repositories and verify test results
- track and sync pull requests linked to a single feature across different projects

## Example prompts
- Run multi-repo-swarm to upgrade TypeScript to 5.0.0 in all repositories with TypeScript in their stack
- Coordinate refactoring from OldAPI to NewAPI: analyze impact across all projects and generate a migration guide
- Scan all repositories for vulnerabilities, apply patches, and create a compliance report

## 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
- [multi-repo-git-ops](https://affpapa.org/en/nevibecode/skills/multi-repo-git-ops.md) — skill · 104 installs
- [dyad:swarm-pr-review](https://affpapa.org/en/nevibecode/skills/dyadswarm-pr-review.md) — skill · ★ 22348 repo stars
- [create-pull-request](https://affpapa.org/en/nevibecode/commands/create-pull-request.md) — command · 411 installs
- [github-cli](https://affpapa.org/en/nevibecode/skills/github-cli.md) — skill · 128 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
