Claude Squad

Claude Squad is a terminal app that manages multiple Claude Code, Codex (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

demo.mp4

Installation

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 | bash

This 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.

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:

cs

To use Claude Squad with Codex or another AI assistant:

1. Set your OpenAI API key in your environment: export OPENAI_API_KEY=<key>
2. Run cs -p "codex" or cs -p "aider" or modify your config file (path can be found by running 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

How It Works

1. tmux to create isolated terminal sessions for each agent
2. git worktrees to isolate codebases so each session works on its own branch
3. A simple TUI interface for easy navigation and management

License

AGPL-3.0