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.

• 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

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.

• tmux
• gh

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
  -s, --simple           Simple mode: run Claude in current directory (no worktree) with auto-yes enabled and immediate prompt
  -h, --help             help for claude-squad
  -p, --program string   Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b')
      --web              Enable web monitoring server
      --web-port int     Web monitoring server port (default from config)

Run the application with:

cs                  # Standard mode with multiple instances
cs -s               # Simple mode: run in current directory with auto-yes
cs -p "aider" -s    # Simple mode with a specific program

Using Claude Squad with other AI assistants:

• For Codex: Set your API key with export OPENAI_API_KEY=<your_key>
• Launch with specific assistants:
  • Codex: cs -p "codex"
  • Aider: cs -p "aider ..."
• Make this the default, by modifying the config file (locate with cs debug)

The menu at the bottom of the screen shows available commands:

• n - Create a new session
• N - Create a new session with a prompt
• D - Kill (delete) the selected session
• ↑/j, ↓/k - Navigate between sessions

• ↵/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

• tab - Switch between preview tab and diff tab
• q - Quit the application
• shift-↓/↑ - scroll in diff view

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

1. Launches Claude directly in your current repository directory
2. Automatically enables auto-yes
3. Opens a prompt dialog immediately to get started
4. Simplifies the UI for a streamlined experience
5. No worktree creation or branch isolation (changes directly to your working directory)

1. Enables a web server for remote monitoring of Claude instances
2. Provides a RESTful API for accessing instance data
3. Includes WebSocket support for real-time terminal output streaming
4. Visualizes git diffs and instance status
5. Features a modern React frontend with real-time updates
6. Secure authentication and rate limiting for remote access

Run with web monitoring enabled:

cs --web                      # Enable web monitoring on default port (8080)
cs --web --web-port=9000      # Use a specific port
cs --web --react              # Enable web monitoring with modern React UI 
cs -s --web --react           # Simple mode with React web UI (recommended)

Access the web UI at http://localhost:8080/ (or your configured port)

The web interface provides:

• Instance listing with status indicators
• Real-time terminal streaming with xterm.js
• Responsive layout that works on desktop and mobile devices
• Automatic reconnection if connection is lost

The modern React frontend offers additional features:

• Enhanced terminal experience with better rendering
• Improved instance management interface
• Support for desktop and mobile browsers
• Responsive design for various screen sizes
• Real-time updates using WebSockets
• Proper handling of binary and text protocols

AGPL-3.0