github/squad

What is it?

Key features

• 01Creates a persistent AI team with roles and charters stored as files in the repo.
• 02Runs multiple agents in parallel under a coordinator that routes tasks by role.
• 03Records decisions and per-agent history so knowledge carries across sessions.
• 04Watch mode polls GitHub issues, triages them, and can dispatch Copilot agents.
• 05Projects the same team into Claude Code, Kiro, OpenCode, Cursor, Codex, and Antigravity.
• 06Offers a TypeScript SDK for defining teams in code.

Use cases

• Starting a new project and letting an AI team propose roles and split up early work.
• Triaging and working through a backlog of GitHub issues with human review at each step.
• Sharing a consistent AI team configuration with everyone who clones a repository.
• Building a .NET or TypeScript application that calls a Squad team programmatically.

Quick start

1. 1

   Create and enter your project folder

   mkdir my-project && cd my-project
2. 2

   Install the Squad CLI with npm (requires Node.js 22.5+)

   npm install -g @bradygaster/squad-cli
3. 3

   Initialize Squad in the project

   squad init
4. 4

   Open Copilot with the Squad agent and set up your team

   copilot --agent squad --yolo

Things to know

• !Requires GitHub Copilot to run the agent team.
• !Needs Node.js 22.5+ for the npm install route, or use a platform installer.
• !Breaking changes between versions are documented in the CHANGELOG, so review it before upgrading.

In collections

Topics

FAQ

What is squad?

Human-led AI agent teams that live as files in your repo, working through GitHub Copilot and other AI hosts to help you build and coordinate code. Squad is a CLI and SDK that sets up a team of AI agents for a software project. You describe what you are building, and Squad proposes specialist roles such as lead, frontend, backend, and tester. Each member is defined in markdown files under a .squad/ folder in your repository, so the team's charters, routing rules, decisions, and per-agent history are versioned with the code and shared with anyone who clones it.

Is squad free to use? What license does it have?

squad is open source under the MIT license. Check the license terms before using it in commercial products.

Is squad still maintained?

Actively maintained. The last commit to squad was on Nov 6, 2026.

What can I use squad for?

Starting a new project and letting an AI team propose roles and split up early work. Triaging and working through a backlog of GitHub issues with human review at each step. Sharing a consistent AI team configuration with everyone who clones a repository. Building a .NET or TypeScript application that calls a Squad team programmatically.

How do I install squad?

Create and enter your project folder: mkdir my-project && cd my-project Install the Squad CLI with npm (requires Node.js 22.5+): npm install -g @bradygaster/squad-cli Initialize Squad in the project: squad init Open Copilot with the Squad agent and set up your team: copilot --agent squad --yolo

Where can I get squad?

The source code and installation instructions are on GitHub: https://github.com/github/squad