Claude Squad is an open-source terminal app written in Go that runs several AI coding agents such as Claude Code, Codex, Gemini CLI or Aider in parallel. Every instance runs in its own tmux session and its own Git worktree with its own branch; you review changes in the diff before you commit and push them. As of 22 November 2026.
What is Claude Squad?
Claude Squad is a free, open-source project of the GitHub organization smtg-ai, licensed under AGPL-3.0. The smtg-ai/claude-squad repository was created in March 2025, and the first release, v1.0.0, came out on 3 April 2025. The current version is v1.0.20 from 20 August 2026 according to the release list, the latest commit dates from 13 November 2026, and the repository has 8,848 GitHub stars (GitHub API, 22 November 2026). Claude Squad is installed via Homebrew (brew install claude-squad) or an install script as the cs command. It requires tmux and the GitHub CLI gh. macOS and Linux are documented; the release files do include Windows builds, but the README does not describe Windows, and the install script refers to WSL for tmux on Windows.
Claude Squad as an AI harness
As an AI harness, Claude Squad covers only the orchestration building block: it starts agents, isolates their work and shows their state in a list. According to the README, the tool rests on three parts: tmux for a separate terminal session per agent, Git worktrees for a separate branch per session, and a lean terminal interface. With n you create a new instance, with N directly with a prompt. With Enter or o you attach to an instance to give further instructions, and ctrl-q detaches again. A preview tab shows the terminal output, a diff tab the changes in the worktree. c commits the changes and pauses the instance so you can check out the branch locally, r resumes it, and s commits and pushes the branch to GitHub. Profiles in ~/.claude-squad/config.json define which agents you can choose when creating an instance. Claude Squad offers no hooks, plugins, MCP or API for control by other agents.
Models and model access
Claude Squad is model-agnostic: it starts the chosen agent CLI, and that agent determines model, provider and access route. The default program is claude; with -p or a profile you start other agents, and the README gives aider --model ollama_chat/gemma3:1b as an example for a local model via Ollama. For Codex, the README refers to the OPENAI_API_KEY environment variable. Subscription use is not documented explicitly; since Claude Squad starts the agents under your user account, an existing login of the agent stays in effect. Whether model access runs through a central proxy such as innFactory’s AI Gateway depends on the configuration of the respective agent.
Company use: data protection and governance
Claude Squad runs entirely locally; the critical point for companies is the auto-accept mode. With the -y parameter or the auto_yes setting, Claude Squad automatically confirms detected approval prompts from Claude Code, Aider and Gemini CLI by sending Enter. When you quit the interface, it starts a background process for this that keeps monitoring all instances. The README marks the mode as experimental, and it is off by default. A worktree only isolates files in the repository, not processes, network access or credentials; in companies, auto-accept should therefore stay off or only run in an isolated environment.
Configuration, instance state and worktrees are stored under ~/.claude-squad. The project documents no telemetry, and based on our review of the v1.0.20 source code, Claude Squad opens no network connections apart from Git and the GitHub CLI. There is no user management, SSO or central policy. The AGPL-3.0 license permits internal use; anyone who distributes a modified version or makes it available over a network must disclose its source code. Check compatibility with your open-source policy. Between the release on 20 August 2026 and 22 November 2026, there was only one further commit. Source code and prompts of the launched agents go to their model providers and belong in your records of processing.
Which agents does Claude Squad support?
Claude Squad starts any CLI that runs in a terminal via the -p parameter or a profile. The README names Claude Code as the default as well as Codex, Gemini CLI and Aider; the project website names Claude Code, Codex and Aider, and the repository description also names OpenCode and Amp. According to the source code, Claude Squad detects approval prompts via the screen text only for Claude Code, Aider and Gemini CLI, and auto-accept only applies there. Other agents run as ordinary terminal processes in their instance.
How it fits: Claude Squad, herdr, Orca and the AI Gateway
Claude Squad is the leanest approach among the orchestrators: tmux and Git worktrees with an interface on top, without cloud services and without telemetry. herdr also relies on the terminal, detects the state of many agents more precisely and offers a CLI and socket API through which agents control each other. Orca shares the “one task, one worktree” principle with Claude Squad but brings a desktop app with editor, browser and pull requests. cmux is a native macOS terminal with notifications and a socket API. You will find a detailed comparison in the article herdr vs. Orca. None of the orchestrators captures developers’ costs and agent time across teams and projects; the AI Gateway does that in proxy and companion mode. For business users outside development, CompanyGPT is the right harness; our AI harness overview gives an overview.
