↓ Skip to main content
tomrochette.com
  1. Agents/
  2. Orchestration/

Squad

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 5 minutes read (~984 words)
agent-curated 610 coding-agents 52 copilot 1 fully-ai-generated 715 llm=glm-5.3-flash 620 multi-agent 59 orchestration 96 research-note 580
Table of Contents

Squad is Brady Gaster’s MIT-licensed CLI that assembles persistent, human-led AI agent teams, frontend, backend, tester, lead, as files inside your repository and runs them through GitHub Copilot CLI.

Squad’s bet is that the right multi-agent primitive for coding is a roster of teammate files versioned in the repo, not a framework import, and 3,249 stars in eight months suggest the bet lands.

What it is
#

A CLI (npm install -g @bradygaster/squad-cli) whose squad init creates a .squad/ directory holding team.md, member files, charters, and routing rules; each member runs in its own context, reads only its own knowledge, and writes back what it learned so the work stays inspectable (README). Sessions run inside GitHub Copilot CLI (copilot --agent squad), with GitHub authentication wired for issues, PRs, and a workflow the README calls Ralph; a --preset default flag gives a configured team instantly. The repo sits at 3,282 stars with 507 forks, MIT, created 2026-02-06, TypeScript (GitHub API, as of 2026-10-15). It entered this pile from the Awesome Multi-Agent Orchestrators directory’s new entries.

Status
#

Active: last push 2026-11-08, latest stable v1.1.0 on 2026-10-20, a dev-to-main promotion riding the release train, after v1.0.1 (2026-10-04, a release-packaging fix for the Homebrew and WinGet publish credentials, one day after v1.0.0 promoted the dev line to main), with a v2.0.0 preview line opened 2026-10-24 and running through v2.0.0-preview.3 (2026-11-01, all prereleases) (GitHub API, as of 2026-11-08). The identity record moved: the repository transferred from bradygaster’s account into the github organization between the 2026-11-03 verification and 2026-11-07, the old path a 301 redirect, the same organization churn this section recorded on Agent Orchestrator and Ruflo. The 1.0.0 wave caps the alpha period: the README no longer carries the alpha badge that earlier releases warned about, though the project is still a solo-maintainer CLI and the API caveats deserve re-reading before you script against it. Traction is concentrated: npm recorded 13,000 downloads of @bradygaster/squad-cli in the month ending 2026-10-26, down slightly from 14,360 in the window ending 2026-10-09, with 1,118 in the week ending the same day. Independent discussion is nearly absent: the largest HN thread I found has 2 points, so the footprint is GitHub plus npm alone, which is itself a signal.

Star History Chart

Strengths
#

  • Files-as-teammates is inspectable by design: charters, routing rules, and member knowledge are versioned Markdown, so the multi-agent setup diffs and reviews like code.
  • It rides GitHub Copilot CLI, so there is no new agent runtime to host, authenticate, or pay for separately beyond Copilot access.
  • The human-led stance is explicit in the README: people keep accountability for priorities, approvals, and final changes.
  • Fast iteration (v0.13.1 by month eight) and a one-flag preset lower the start cost to nearly nothing.

Cautions
#

  • Hard-locked to GitHub Copilot CLI; if you use Claude Code, Codex, or OpenCode, this tool is not for you.
  • Alpha with documented breaking changes, so team files you build now may need migration later.
  • Community scrutiny is thin: a 2-point HN thread and no third-party coverage I could find, so traction numbers rest on the maintainer’s own channels.
  • The teammate-files model is young and unproven at scale; it is a productivity experiment by a single known maintainer, not a supported product.

Pricing
#

Free and open source under MIT; Squad itself has no paid tier. It requires a GitHub Copilot subscription to run sessions, which is the real cost line.

Compared to
#

  • MetaGPT: the role-company framework precedent; MetaGPT hard-codes a software company in Python, Squad keeps roles as editable repo files and runs on Copilot.
  • The Perfect Orchestrator: the lead-plus-workers bash pattern; both keep a human lead in charge, but that one orchestrates raw Claude Code sessions while Squad structures teams as files.
  • LoopTroop: the local GUI orchestrator with council planning; LoopTroop is multi-model and GUI-first, Squad is Copilot-only and repo-first.

Bottom line
#

Recommended for individual developers already living in GitHub Copilot CLI who want persistent, reviewable multi-agent teamwork with a human in charge. Not for teams on other agent runtimes, or anyone who needs a stable, community-validated API today.

Changes
#

  • 2026-09-29 - Created when the new-entries list from the Awesome Multi-Agent Orchestrators directory resolved.
  • 2026-10-03 - Status move: v1.0.0 published October 3 (dev line promoted to main), the README no longer badges the project alpha, and star count refreshed to 3,251.
  • 2026-10-05 - Recorded v1.0.1 (October 4, Homebrew and WinGet publish-auth fix) as the latest release and refreshed the npm monthly downloads.
  • 2026-10-07 - Added the bradygaster/squad star history chart to the Status section.
  • 2026-10-26 - Re-verified in rotation: all cited sources re-fetched and live (repo, releases, npm registry and downloads, HN thread); push refreshed to 2026-10-26 and npm traction refreshed to 13,000 downloads in the month ending 2026-10-26, down from 14,360 ending 2026-10-09.
  • 2026-11-03 - Re-verified in rotation: all cited sources re-fetched and live (repo, README, releases, npm registry and download points, HN item); the push date refreshed to 2026-11-02, v1.1.0 (2026-10-20) still the latest release.
  • 2026-11-07 - Recorded the repository’s transfer from bradygaster’s account into the github organization (old path a 301), moved the star-history chart and repository references to the canonical github/squad paths, and refreshed the push date to 2026-11-06.

See also
#

References
#