Powered by GitHub Copilot SDK

One prompt.
An entire engineering team.

Stop prompting one agent at a time. Copilot Swarm spawns a full team of AI agents — PM, designer, engineers, reviewers, and testers — that collaborate, review each other's work, and ship production-ready code. All from a single command.

Get Started ⭐ Star on GitHub
terminal
$ npx @copilot-swarm/core "Add OAuth login with PKCE"

🐝 Copilot Swarm v1.0.0 · claude-opus-4-6 · /my-app

Phase ✔ Spec ✔ Decompose ◆ Implement → Verify

Streams
   stream-0  auth/oauth-pkce.ts  done
   stream-1  auth/token-rotation.ts  done
   stream-2  components/LoginForm.tsx  testing

Active Agents
  ▸ QA Engineer  stream-2 · 01:23

Built for real engineering workflows

Not just another AI wrapper. Copilot Swarm mimics how high-performing engineering teams actually work.

🏗️

Declarative Pipeline

Define your entire workflow in a YAML config — agents, phases, review loops, and conditions. Zero code changes to customize.

Parallel Execution

Independent tasks run simultaneously in separate streams. Backend and frontend work happens concurrently. Wave-based execution for dependent tasks.

🔄

Self-Correcting Loops

Every agent is paired with a reviewer. Code review and QA loops catch issues before they ship. Up to 3 review iterations per phase.

🧠

Cross-Model Review

A different AI model reviews the final output, catching systematic blind spots and biases specific to the primary model.

💾

Checkpoint & Resume

Every phase, iteration, and stream is checkpointed. Resume from exactly where you left off. Auto-retry on transient failures.

🚢

Fleet Mode

Orchestrate features across multiple repositories. Shared contracts, dependency-ordered waves, and cross-repo consistency review.

📋

Interactive Planning

Refine vague requirements before running. PM, engineer, and designer each clarify from their perspective, all reviewed independently.

Built-in Verification

Post-implementation verification runs your actual build, test, and lint commands. Auto-detects from package.json, Cargo.toml, go.mod, and more.

🖥️

TUI Dashboard

Full-screen terminal dashboard showing phase progress, active agents with elapsed time, stream status, and activity log. Real-time visibility.

A structured, multi-phase pipeline

Each phase produces artifacts that feed the next. Reviews ensure quality at every step.

📝 Spec PM + Reviewers
🔀 Decompose PM
🎨 Design Designer + Review
⚙️ Implement Eng + CR + QA
🧠 Cross-Model Alt Model Review
Verify Build + Test + Lint

11 specialized agents, one team

Each agent has a distinct role, tools, and expertise — just like a real engineering team.

📋

Product Manager

Analyzes requirements, writes specs, decomposes work into tasks, answers clarification requests.

🎯

Creative Reviewer

Challenges the PM's spec, pushes for better product thinking and completeness.

🏛️

Technical Architect

Validates feasibility, flags risks, ensures alignment with existing architecture.

🎨

UI/UX Designer

Creates component designs, interaction flows, and accessibility-compliant layouts.

🖌️

Design Reviewer

Evaluates designs for usability, accessibility, and design system consistency.

💻

Senior Engineer

Implements the specification — reads code, writes code, runs builds and tests.

🔒

Code Reviewer

Security & quality gate. Reviews for correctness, vulnerabilities, and standards.

🧪

QA Engineer

Validates implementation against the spec. Runs tests, checks acceptance criteria.

🧠

Cross-Model Reviewer

Different AI model provides fresh, unbiased assessment catching model-specific blind spots.

🗺️

Fleet Strategist

Coordinates multi-repo features: shared contracts, dependency graphs, execution waves.

🔗

Fleet Reviewer

Verifies cross-repo consistency, interface compatibility, and integration completeness.

Up and running in 60 seconds

Copilot Swarm runs anywhere Node.js and GitHub Copilot are available. No config needed.

1

Install

Install globally or run directly with npx — no project setup required.

npm install -g @copilot-swarm/core
2

Plan

Interactively refine your requirements with PM, engineer, and designer agents.

swarm plan "Add OAuth login with PKCE flow"
3

Run

Execute the full pipeline — agents spec, decompose, implement, review, test, and verify.

swarm --plan .swarm/plans/plan-latest.md
4

Ship

Review the changes, commit, and push. The agents handled the heavy lifting.

git add -A && git commit -m "feat: OAuth login with PKCE"

Multiple modes for every workflow

From quick tasks to multi-repo orchestration — pick the right tool for the job.

🚀

Task Mode

Lightweight autonomous pipeline for well-scoped tasks. Skips the full planning ceremony — PM review, decompose, implement, verify.

🤖

Auto Mode

Fully autonomous: analysis → planning → implementation in one shot. No interaction needed. Perfect for CI/CD and batch processing.

💡

Brainstorm Mode

Explore ideas with a product strategist agent. Interactive Q&A that challenges assumptions and generates structured summaries.

🔍

Analyze Mode

Generate a comprehensive repository context document. Dual-model review ensures accuracy. Cached centrally for reuse.

📝

Review Mode

Provide feedback on a previous run. Agents receive the original context plus your feedback and apply targeted fixes.

🌐

Fleet Mode

Coordinate features across multiple repositories with shared contracts, execution waves, and cross-repo consistency review.

Ready to build with a full AI team?

Open source. Runs locally. Powered by GitHub Copilot.