
GitHub Squad: Your AI Dev Team Living Inside the Repo
We are rapidly moving to a world where multiple agents are the default pattern for many tasks. Each agent has its own agenda, expertise, and perspective — and together they collaborate to solve complex problems faster and more reliably than a single model ever could.
Why not just stuff everything into a bigger context window and let one super-prompted agent handle it all?
Sure, larger contexts help, but they come with trade-offs:
- Context dilution — The model spends cognitive budget recalling irrelevant details from 200k tokens ago.
- Role confusion — A single agent tries to switch hats constantly (planner → coder → tester → reviewer), often leading to inconsistent tone, forgotten details, or hallucinated steps.
- Opacity — When something goes wrong, it’s hard to debug which “part” of the agent’s brain failed.
- Scalability limits — As tasks get more complex (full-stack apps, testing across environments, docs + infra), one agent becomes a bottleneck.
Multi-agent systems distribute the work like a real team: specialized roles, clear handoffs, parallel progress, and built-in review cycles. The result? Cleaner output, fewer loops, and surprisingly human-like collaboration.
Enter GitHub Squad
Squad (built by Brady Gaster, a PM Architect at Microsoft working on CoreAI) brings this multi-agent philosophy directly into your GitHub repository using GitHub Copilot under the hood, specifically leveraging the GitHub Copilot CLI.
Instead of external orchestration servers, heavy YAML configs, or complex agent frameworks, Squad does something radical:
- It initializes a small, pre-configured team of AI specialists as files right inside your
.squad/directory. - The team lives in your repo: inspectable, version-controlled, and evolving alongside your code.
- No external dashboards or databases needed. It runs via the Copilot CLI in your terminal.
Typical default team roles include:
- Lead — Coordinates, breaks down tasks, delegates, reviews pull requests
- Frontend Developer — Handles UI, styling, components, accessibility
- Backend Developer — APIs, business logic, databases, security
- Tester — Writes unit/integration tests, catches regressions
You describe what you want to build (or fix, refactor, add), and the Lead routes work to the right specialists, who then collaborate — spawning sub-tasks, reading files, editing code, running commands, and proposing changes — all tracked transparently.
Getting Started Is Stupidly Simple
Two commands and you’re running a multi-agent dev team:
- Install the Squad CLI globally (one time):
bashnpm install -g @bradygaster/squad-cli
(Or usenpx @bradygaster/squad-cliif you prefer zero global installs.)
- In any existing repo (or a fresh one), initialize your squad:
bashsquad init
This creates a .squad/ folder containing:Validate: Run git status. You should see the new files staged or untracked.
team.md— Defines your agents, their roles, and personalities- Role-specific prompt files
- Config for how agents communicate and delegate

From there, open your terminal in the repo and start directing the team via the Copilot CLI (make sure you have GitHub Copilot access enabled).
Example workflow:
- “squad: build a simple task tracker app with React frontend and Node/Express backend”
- The Lead breaks it down → delegates frontend and backend work → Tester writes tests → everyone iterates until PRs are ready.
Because everything happens via the Copilot CLI, you get:
- File edits proposed directly
- Terminal command execution
- Git commit / push integration
- Readable conversation history
Why This Feels Different from Other Multi-Agent Tools
Most multi-agent frameworks (LangGraph, CrewAI, AutoGen, etc.) require you to:
- Write a lot of glue code
- Manage state externally
- Fight with prompt drift
- Pay for many parallel LLM calls
Squad bets on repository-native orchestration:
- Agents share full repo context naturally via Copilot
- Work is inspectable as markdown files and chat logs
- No vendor lock-in beyond GitHub Copilot itself
- Extremely low setup friction — ideal for side projects, prototypes, or teams experimenting with agents
It’s still early (actively developed in early 2026), but the community is already building extensions, remote control tools, telemetry integrations, and more advanced patterns (looping agents, GitHub Issues integration, etc.).
Try It Yourself
Head to the repo: https://github.com/bradygaster/squad
Follow the README to install, init, and throw a problem at your new AI team. Start small. Ask it to refactor a function, add tests, or scaffold a feature and watch how the agents divide and conquer.
The future of coding isn’t one god-like model. It’s teams of focused specialists working in concert.
And thanks to tools like Squad, that future is already git-init away.
Happy squad-ing!


