Claude Squad

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.

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

Manual

Claude Squad can also be installed by running the following command:

This puts the cs binary in ~/.local/bin.

To use a custom name for the binary:

Prerequisites

- tmux
- gh

Usage

Run the application with:

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…