
Claude Squad
github.com/smtg-ai/claude-squad- Category
- Developer Tools
- Rank
- No. 376Tools index
- Listed in
- #10 Interface with your agents
- Pricing
- Open Source
- Platform
- cli
- Type
- TOOL
- Builder
- smtg-ai
- GitHub
- 8.3k stars
- Latest release
- v1.0.19
- Added
- Jul 2, 2026
About
Claude Squad is a terminal app that lets you manage multiple AI coding assistants (Claude Code, Codex, Gemini, Aider) simultaneously in isolated git workspaces. Each agent runs in its own tmux session with its own branch, so you can parallelize tasks without conflicts. Review and commit changes before merging, all from a single TUI interface.
What it does
Claude Squad turns agent work into a visible handoff loop. Start named tasks, watch terminal output, inspect colored diffs and change counts, then pause, resume, check out, or push the resulting branch. Profiles let you choose different assistant commands when creating sessions.
Why it's ranked here
This is a strong pick for engineers already comfortable with terminal and Git workflows. It keeps agent output inspectable, preserves sessions, shows branch-level change statistics, and supports direct handoff through local checkout or GitHub push. Its narrow scope makes the operating model easy to understand.
What's good
The interface exposes useful state instead of merely launching processes. It marks sessions as loading, running, ready, or paused, previews terminal activity, and provides scrollable diffs. Sessions survive application restarts through stored state. Named profiles also make switching among Claude, Codex, Aider, Gemini, or custom commands practical.
Tradeoffs
It requires tmux and the GitHub CLI, and normal operation must begin inside a Git repository. Codex also needs an API key configured separately. Automatic prompt acceptance is explicitly experimental. The documentation disagrees on the push shortcut: one section says “s,” while the implemented help and bindings use “p.”
How to use it well
Use it when several independent coding tasks can progress on separate branches and a human will inspect each handoff. Create profiles for recurring assistant configurations, monitor previews, review diffs, then check out locally or push to GitHub. It does not supply a coding assistant or its credentials; those remain separate dependencies.
Technical notes+
go.mod defines a Go module using Cobra plus the Bubble Tea, Bubbles, and Lip Gloss terminal stack. main.go checks that the current directory is a Git repository, loads configuration, handles daemon and auto-accept behavior, and exposes reset, debug, and version commands. app/app.go creates the alternate-screen TUI with mouse scrolling, persistent instance storage, preview, diff, and terminal panes. ui/diff.go colors additions, deletions, and hunk headers; ui/terminal.go caches a separate shell tmux session per instance worktree. keys/keys.go binds push to p, despite the conflicting s shortcut in README.md. Configuration is stored at ~/.claude-squad/config.json.
Observed
- License
- AGPL-3.0
- Primary language
- Go
- Interface
- Command-line application with an interactive terminal UI
- Installation
- Homebrew formula or shell installer producing the cs binary
- Runtime prerequisites
- tmux and GitHub CLI
- Agent launch surface
- Named profiles or a program flag can run Claude, Codex, Aider, Gemini, or another local command
Read from README.md, go.mod, main.go, ui/err.go, app/app.go, cmd/cmd.go, log/log.go, ui/diff.go, ui/list.go, ui/menu.go, app/help.go, keys/keys.go, ui/consts.go, ui/preview.go, ui/terminal.go.
What it can do
Run multiple AI coding agents simultaneously in parallel
Multiple coding tasks or prompts assigned to different AI agents → Parallel AI agent sessions each working independently on separate tasks
Isolate each AI agent in its own git worktree and branch
A new AI agent session spawned within the app → Separate git branch and worktree preventing conflicts between concurrent agents
Review and commit AI-generated code changes
Code changes produced by an AI agent in its isolated workspace → Reviewed, committed, and mergeable git changes
Switch between different AI coding assistants using profiles
A profile configuration specifying an AI assistant (Claude Code, Codex, Gemini, or Aider) → Agent session running the selected AI assistant with the configured settings
Manage all active AI agent sessions from a single interface
Multiple running tmux-based AI agent sessions → Unified terminal UI dashboard displaying and controlling all active agents
Enable auto-accept mode for AI agent actions
Toggle setting applied to an AI agent session → Agent that automatically accepts and applies its own suggested changes without manual approval
Merge AI-generated branch changes into the main codebase
Completed and reviewed AI agent branch with committed changes → Merged code integrated into the target branch of the repository
Tags
Tech Stack
Comments (0)
No comments yet
Indexed by a proprietary survey. Corrections welcome.