# Multi Repo Swarm

Runs the multi-repo-swarm agent role from the ruflo multi-agent toolkit.

- Repository: https://github.com/ruvnet/ruflo (80531 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ruvnet/ruflo --skill agent-multi-repo-swarm -g -a claude-code -y`
Codex: `npx skills add ruvnet/ruflo --skill agent-multi-repo-swarm -g -a codex -y`
Cursor: `npx skills add ruvnet/ruflo --skill agent-multi-repo-swarm -g -a cursor -y`
Gemini CLI: `npx skills add ruvnet/ruflo --skill agent-multi-repo-swarm -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ruvnet/ruflo`

## Description

Agent skill for multi-repo-swarm - invoke with $agent-multi-repo-swarm

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

---
name: multi-repo-swarm
description: Cross-repository swarm orchestration for organization-wide automation and intelligent collaboration
type: coordination
color: "#FF6B35"
tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - LS
  - TodoWrite
  - mcp__claude-flow__swarm_init
  - mcp__claude-flow__agent_spawn
  - mcp__claude-flow__task_orchestrate
  - mcp__claude-flow__swarm_status
  - mcp__claude-flow__memory_usage
  - mcp__claude-flow__github_repo_analyze
  - mcp__claude-flow__github_pr_manage
  - mcp__claude-flow__github_sync_coord
  - mcp__claude-flow__github_metrics
hooks:
  pre:
    - "gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)"
    - "git status --porcelain || echo 'Not in git repository'"
    - "gh repo list --limit 1 >$dev$null || (echo 'No repo access' && exit 1)"
  post:
    - "gh pr list --state open --limit 5 | grep -q . && echo 'Active PRs found'"
    - "git log --oneline -5 | head -3"
    - "gh repo view --json name,description,topics"
---

# Multi-Repo Swarm - Cross-Repository Swarm Orchestration

## Overview
Coordinate AI swarms across multiple repositories, enabling organization-wide automation and intelligent cross-project collaboration.

## Core Features

### 1. Cross-Repo Initialization
```bash
# Initialize multi-repo swarm with gh CLI
# List organization repositories
REPOS=$(gh repo list org --limit 100 --json name,description,languages \
  --jq '.[] | select(.name | test("frontend|backend|shared"))')

# Get repository details
REPO_DETAILS=$(echo "$REPOS" | jq -r '.name' | while read -r repo; do
  gh api repos$org/$repo --jq '{name, default_branch, languages, topics}'
done | jq -s '.')

# Initialize swarm with repository context
npx ruv-swarm github multi-repo-init \
  --repo-details "$REPO_DETAILS" \
  --repos "org$frontend,org$backend,org$shared" \
  --topology hierarchical \
  --shared-memory \
  --sync-strategy eventual
```

The rest: https://github.com/ruvnet/ruflo/blob/HEAD/.agents/skills/agent-multi-repo-swarm/SKILL.md