Claude Squad is a terminal app that manages multiple Claude Code (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
- 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
demo.mp4
The easiest way to install claude-squad is by running the following command:
curl -fsSL https://raw.githubusercontent.com/stmg-ai/claude-squad/main/install.sh | bashThis will install the cs binary to ~/.local/bin and add it to your PATH. To install with a different name, use the --name flag:
curl -fsSL https://raw.githubusercontent.com/stmg-ai/claude-squad/main/install.sh | bash -s -- --name <name>Alternatively, you can also install claude-squad by building from source or installing a pre-built binary.
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:
csTo use a specific AI assistant program:
cs -p "aider --model ollama_chat/gemma3:1b"or modify the config file (path can be found by running 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 menu
tab- Switch between preview tab and diff tabq- Quit the applicationshift-↓/↑- scroll in diff view
- tmux to create isolated terminal sessions for each agent
- git worktrees to isolate codebases so each session works on its own branch
- A simple TUI interface for easy navigation and management