# Claude Squad

> A terminal app that manages multiple AI coding agents (Claude Code, Codex, Gemini, Aider) in isolated git workspaces, enabling parallel task execution from a single terminal window.

Claude Squad is an open-source terminal application written in Go that lets you run and manage multiple AI coding agents simultaneously in isolated environments. It uses tmux to create separate terminal sessions and git worktrees to give each agent its own branch, eliminating conflicts when working on multiple tasks at once. The tool supports Claude Code, OpenAI Codex, Google Gemini CLI, Aider, and other local agents, all controllable from a single TUI interface.

- **Multi-agent management** — *run `cs` to launch the TUI and create multiple sessions, each running a different AI agent or task in parallel*
- **Isolated git workspaces** — *each session gets its own git worktree and branch, so agents never conflict with each other's changes*
- **Auto-accept / yolo mode** — *use the `-y` flag to have all instances automatically accept prompts without manual intervention, enabling fully background task completion*
- **Diff and preview tabs** — *switch between a live preview tab and a diff tab with `tab` to review changes before committing or pushing*
- **Commit and push workflow** — *press `s` to commit and push a branch to GitHub, or `c` to checkpoint changes and pause a session*
- **Profile-based configuration** — *define named profiles in `~/.claude-squad/config.json` to quickly switch between different agents (Claude, Codex, Aider) when creating sessions*
- **Homebrew and curl installation** — *install via `brew install claude-squad` or a one-line curl script; the binary is available as `cs`*
- **Flexible agent support** — *launch any agent with `-p "program"`, e.g., `cs -p "codex"` or `cs -p "aider --model ollama_chat/gemma3:1b"`, and set a default in config*
- **Session lifecycle controls** — *create, attach, detach, pause, resume, and delete sessions from the keyboard-driven menu at the bottom of the screen*

## Features
- Multi-agent parallel execution
- Isolated git worktrees per session
- tmux-based terminal session management
- Auto-accept / yolo mode
- Diff and preview tabs
- Commit and push to GitHub
- Profile-based agent configuration
- Homebrew and curl installation
- Support for Claude Code, Codex, Gemini, Aider
- Keyboard-driven TUI interface

## Integrations
Claude Code, OpenAI Codex, Google Gemini CLI, Aider, tmux, GitHub CLI (gh), git

## Platforms
MACOS, LINUX, API, CLI

## Pricing
Open Source

## Version
v1.0.17

## Links
- Website: https://smtg-ai.github.io/claude-squad/
- Documentation: https://github.com/smtg-ai/claude-squad#readme
- Repository: https://github.com/smtg-ai/claude-squad
- EveryDev.ai: https://www.everydev.ai/tools/claude-squad
