Orchestrate multiple GitHub Copilot agents in a sequential, hierarchical workflow. Define a research specialist, an architect, and a coder, and let them solve complex tasks by passing context from one to another.
All processing is done natively through the official VS Code Language Model API. No external APIs, no extra costs beyond your Copilot subscription.
Features
Hierarchical Swarms: Run agents in order. Each agent reads what the previous one produced.
Dynamic Model Selection: Select any model authorized in your subscription (GPT-4o, Claude 3.5, etc.).
Security System: Set a global token budget. The swarm auto-stops if you exceed your limit.
Persistent Metrics: Track your total usage across VS Code sessions.
Conflict Resolution: Integrated "Global History" system where agents detect and resolve contradictions from previous steps.
Conflict Resolution & Arbitration
When multiple agents work together, conflicts are bound to happen. CopilotSwarm solves this via Hierarchical Arbitration:
Global Context Window: Every agent in the chain receives the entire history of decisions made by previous agents.
Self-Correction Prompting: Each agent is explicitly instructed to spot and fix contradictions found in the history.
The Consensus Arbitrator: By default, a final "Arbitrator" agent acts as the supreme judge, reconciling any final disagreements and outputting a single cohesive project vision.
Installation
From the Marketplace
The easiest way to get started is to install CopilotSwarm directly from the Visual Studio Marketplace.
Open VS Code.
Go to the Extensions view (Ctrl+Shift+X).
Search for CopilotSwarm.
Click Install.
Manual Installation (VSIX)
If you'd rather build it yourself or install the .vsix file:
Clone the repo.
Run npm install and npm run build.
Package it with npx @vscode/vsce package.
Install the resulting .vsix from the Extensions menu.
Requirements
VS Code 1.90+
An active GitHub Copilot subscription (log in through VS Code).
How to Use
Open the command palette (Ctrl+Shift+P).
Search for "Open Swarm Control Panel".
Define your Global Swarm Objective.
Configure your agents' System Prompts (roles).
Click Run Hierarchy and watch them collaborate!
Created by ZendrYz. Focus on privacy and efficiency. No data leaves your machine except for the standard Copilot API calls.
