smtg-ai /claude-squad
Manage multiple AI terminal agents like Claude Code, Codex, OpenCode, and Amp.
★ 8,812⑂ 636👁 29⑃ 187● 134▤ 20
+2
日增长
8,812
stars
636
forks
29
watchers
187
prs
134
issues
20
releases
README
Claude Squad Claude Squad is a terminal app that manages multiple Claude Code, Codex, Gemini (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously. !Claude Squad Screenshot Highlights - Complete tasks in the background (including yolo / auto-accept mode!) - Manage instances and tasks in one terminal window - Review changes before applying them, checkout changes before pushing them - Each task gets its own isolated git workspace, so no conflicts https://github.com/user-attachments/assets/aef18253-e58f-4525-9032-f5a3d66c975a Installation Both Homebrew and manual installation will install Claude Squad as cs on your system. Homebrew bash brew install claude-squad ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs" Manual Claude Squad can also be installed by running the following command: bash curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash This puts the cs binary in ~/.local/bin. To use a custom name for the binary: bash curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name Prerequisites - tmux - gh Usage Usage: cs [flags] cs [command] Available Commands: completion Generate the autocompletion script for the specified shell debug Print debug information like config paths help Help about any command reset Reset all stored instances version Print the version number of claude-squad Flags: -y, --autoyes [experimental] If enabled, all instances will automatically accept prompts for claude code & aider -h, --help help for claude-squad -p, --program string Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b') Run the application with: bash cs NOTE: The default program is claude and we recommend using the latest version. Using Claude Squad with other AI assistants: - For Codex: Set your API key with export OPENAI_API_KEY= - Launch with specific assistants: - Codex: cs -p "codex" - Aider: cs -p "aider ..." - Gemini: cs -p "gemini" - Make this the default, by modifying the config file (locate with cs debug) Menu The menu at the bottom of the screen shows available commands: Instance/Session Management - n - Create a new session - N - Create a new session with a prompt - D - Kill (delete) the selected session - ↑/j, ↓/k - Navigate between sessions Actions - ↵/o - Attach to the selected session to reprompt - ctrl-q - Detach from session - s - Commit and push branch to github - c - Checkout. Commits changes and pauses the session - r - Resume a paused session - ? - Show help menu Navigation - tab - Switch between preview tab and diff tab - q - Quit the application - shift-↓/↑ - scroll in diff view Configuration Claude Squad stores its configuration in ~/.claude-squad/config.json. You can find the exact path by running cs debug. Profiles
Top issues
#56Enable multiple git repos with claude squad7 comments · 2025-04-06#275Windows binary fails immediately on `n new` — `creack/pty` is unsupported on Windows4 comments · 2026-04-07#312Focus mode: type into a session directly from the list view3 comments · 2026-07-15#260Feature request: worktree environment setup hook (deps, env files, port isolation)3 comments · 2026-03-05#300feat: custom themes2 comments · 2026-05-30#296Feature Request: Compact mode2 comments · 2026-05-22#292feature request1 comments · 2026-05-16#266Bug: SendPrompt sends text before CLI (Codex/others) is ready, prompt lost1 comments · 2026-03-17
Discussions
#348Watching usage limits across several agent sessions from a phone (free this week)0 comments · 2026-11-15#343bulkhead: guards for the processes and ports that squad sessions still share0 comments · 2026-11-12#342Claude Squad: merging the worktrees back is where the collision shows0 comments · 2026-10-30#340Tracking what each squad session is doing from one board0 comments · 2026-10-27#339Coterie: a Windows workspace for planning, parallel coding and cross-model review0 comments · 2026-10-19#338Octuo: an assistant that briefs your coding agents and collects what they produce0 comments · 2026-10-17#337Claude Squad is included in the AgentManager tool catalog0 comments · 2026-10-16#330Reviewing parallel sessions from your phone0 comments · 2026-09-07
Latest release
v1.0.20 v1.0.20 2026-08-20Changelog 2dd388e9857233e07712c8c5b3e2bf3b471b39fa: fix: record base commit for existing-branch sessions (315) (@JDKrasnick) ebb83b2d1aacf20bf817e2b5a76345ffa0a08eac: fix: recover instances whose tmux session died with the server (322) (@Noam5)