smtg-ai /claude-squad

Manage multiple AI terminal agents like Claude Code, Codex, OpenCode, and Amp.

★ 8,812⑂ 636👁 29⑃ 187● 134▤ 20
GoAGPL-3.0Created 2025-03-09smtg-ai.github.io/claude-squad/
Download: v1.0.20v1.0.20 ↓1.0.202026-08-20
+2
Daily
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

Discussions

Latest release

v1.0.20 v1.0.20 2026-08-20
Changelog
 2dd388e9857233e07712c8c5b3e2bf3b471b39fa: fix: record base commit for existing-branch sessions (315) (@JDKrasnick)
 ebb83b2d1aacf20bf817e2b5a76345ffa0a08eac: fix: recover instances whose tmux session died with the server (322) (@Noam5)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON