Manage multiple AI coding agents in isolated git workspaces
Catalog skill by smtg-ai: Manage multiple AI coding agents in isolated git workspaces Install into Cursor, Claude, Codex, or VS Code from this page or review the source for claude-squad.
Ads
brew install claude-squad
Install guides: Cursor skills, Claude Code skills, Codex skills, or VS Code Copilot skills.
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.
https://github.com/user-attachments/assets/aef18253-e58f-4525-9032-f5a3d66c975a
Both Homebrew and manual installation will install Claude Squad as cs on your system.
brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
Claude Squad can also be installed by running the following command:
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:
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name <your-binary-name>
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:
cs
NOTE: The default program is claude and we recommend using the latest version.
Using Claude Squad with other AI assistants:
export OPENAI_API_KEY=<your_key>cs -p "codex"cs -p "aider ..."cs -p "gemini"cs debug)The menu at the bottom of the screen shows available commands:
n - Create a new sessionN - Create a new session with a promptD - Kill (delete) the selected session↑/j, ↓/k - Navigate between sessions↵/o - Attach to the selected session to repromptctrl-q - Detach from sessions - Commit and push branch to githubc - Checkout. Commits changes and pauses the sessionr - Resume a paused session? - Show help menutab - Switch between preview tab and diff tabq - Quit the applicationshift-↓/↑ - scroll in diff viewClaude Squad stores its configuration in ~/.claude-squad/config.json. You can find the exact path by running cs debug.
Profiles let you define multiple named program configurations and switch between them when creating a new session. When more than one profile is defined, the session creation overlay shows a profile picker that you can navigate with ←/→.
To configure profiles, add a profiles array to your config file and set default_program to the name of the profile to select by default:
{
"default_program": "claude",
"profiles": [
{ "name": "claude", "program": "claude" },
{ "name": "codex", "program": "codex" },
{ "name": "aider", "program": "aider --model ollama_chat/gemma3:1b" }
]
}
Each profile has two fields:
| Field | Description |
|---|---|
name | Display name shown in the profile picker |
program | Shell command used to launch the agent for that profile |
If no profiles are defined, Claude Squad uses default_program directly as the launch command (the default is claude).
If you get an error like failed to start new session: timed out waiting for tmux session, update the
underlying program (ex. claude) to the latest version.
AGPL-3.0