Skip to main content
subagent CX Codex

multi-repo-swarm — Claude Code subagent: repository orchestration

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.

no license ★ 850 updated 2026-10-26

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/multi-repo-swarm.md
Open on GitHub

What multi-repo-swarm 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.

What it helps with

  • 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 for the agent

  • 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

How to install multi-repo-swarm

Manually: put the files in place

.claude/agents/multi-repo-swarm.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about multi-repo-swarm

How do I install multi-repo-swarm in Claude Code?

Add the subagent definition to .claude/agents/multi-repo-swarm.md at your project root. Claude Code will read it on startup and load the orchestration tools.

What does multi-repo-swarm do?

It manages multiple agents across different repositories in your organization at once. Use it to make synchronized changes (updates, patches, refactoring) to all projects simultaneously instead of repeating the same operations manually.

What do I need before I can run it?

GitHub CLI must be authenticated. Run gh auth login if you haven't already. The subagent checks this on initialization and will not start without access.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set76

The whole set →
ml-developer ml-developer — a dedicated subagent for training machine learning models, exploring hyperparameter spaces, and editing Jupyter notebooks. CX Codex ★ 850repo stars Load Balancing Coordinator The Load Balancing Coordinator subagent assigns work according to agent load and task priority. Use it to manage queues or move work away from overloaded agents. CX Codex ★ 850repo stars release-swarm release-swarm is a Claude Code command for planning releases from commits and merged pull requests, preparing changelogs, and coordinating publication through GitHub CLI. CX Codex +1 ★ 850repo stars v3-performance-engineer v3-performance-engineer — a subagent that benchmarks claude-flow v3 and pushes it toward stated goals: Flash Attention, HNSW search, cold start, memory. Use it when the numbers are claimed and need proving. CX Codex ★ 850repo stars consensus-coordinator consensus-coordinator — a Claude subagent that computes distributed consensus: Byzantine fault tolerance, voting and agreement across an agent swarm. CX Codex ★ 850repo stars specification SPARC specification subagent for requirements analysis. Gathers acceptance criteria, outlines project scope, and learns from previous patterns via claude-flow. CX Codex ★ 850repo stars pr-manager pr-manager coordinates pull request reviews, tests, and merge work through GitHub tools and a swarm of agents. It can also reuse patterns saved from earlier PR tasks. CX Codex ★ 850repo stars reviewer A reviewer persona for Claude that reads a change like a senior engineer: behaviour, security holes, slow paths, standards, docs. You get a summary with critical issues. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open