multi-repo-swarm

Orchestrates AI agent swarms across multiple GitHub repositories for coordinated automation.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill multi-repo-swarm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multi-repo-swarm
Source: https://github.com/ruvnet/claude-flow/tree/main/.agents/skills/agent-multi-repo-swarm
Command: npx skills add https://github.com/ruvnet/claude-flow --skill multi-repo-swarm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating changes, dependency updates, and refactoring across many repositories in an organization requires repetitive manual work and risks inconsistent states between projects.

Core Features & Use Cases

  • Cross-Repo Swarm Initialization: Discover organization repositories with the GitHub CLI and initialize hierarchical swarms with shared memory and configurable sync strategies.
  • Synchronized Operations: Execute tasks like dependency updates or security patches across matching repositories, automatically creating and linking pull requests.
  • Monitoring & Coordination: Visualize dependency graphs, run health checks, and coordinate via webhooks, GraphQL federation, or Kafka event streaming.
  • Use Case: Update TypeScript to a new version across every service repository in an organization, with a tracking issue, per-repo PRs, and failure reporting handled automatically.

Quick Start

Initialize a multi-repo swarm for my organization's frontend, backend, and shared repositories and create PRs updating dependencies across all of them.

Frequently Asked Questions about multi-repo-swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate changes across multiple GitHub repositories?

Use the multi-repo swarm to discover repositories with the GitHub CLI, initialize a hierarchical swarm with shared memory, then execute synchronized tasks that clone each repo, apply changes, and create linked pull requests automatically.

How to update dependencies across all repos in a GitHub organization?

Create a tracking issue, list repositories containing the dependency via gh api queries, then loop through each repo to update, test, and open PRs referencing the tracking issue. Failures are reported as comments on the tracking issue.

What synchronization strategies does multi-repo coordination support?

It supports eventual consistency with retry and exponential backoff for non-critical updates, strong consistency using raft consensus with quorum for critical operations, and hybrid configurations that override the default per operation type.

Does multi-repo swarm require GitHub CLI authentication?

Yes. The pre-execution hooks verify gh auth status, git repository presence, and repository list access before running. Without GitHub CLI authentication and repo access, the swarm operations will exit with an error.

Can I monitor swarm health across repositories?

Yes. The skill provides a real-time dashboard on a configurable port, dependency graph visualization in Mermaid format, and health checks covering connectivity, memory, and agent status with alerting on issues.