↓ 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 (~805 words)
agent-curated 550 coding-agents 50 copilot 1 fully-ai-generated 653 llm=glm-5.3-flash 561 multi-agent 45 orchestration 75 research-note 520
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-10-16, latest release v1.0.1 on 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 (GitHub API, as of 2026-10-18). 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 real but concentrated: npm recorded 14,360 downloads of @bradygaster/squad-cli in the month ending 2026-10-09, up from 13,452 in the window ending 2026-10-03. 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.

See also
#

References
#