claude-squad

What it is

Claude Squad is a terminal app that manages multiple Claude Code, Codex, Gemini (and other local agents) in separate workspaces, allowing users to work on multiple tasks concurrently. It uses tmux for isolated terminal sessions and git worktrees to keep each session on its own branch.

How it works

The app operates via:

• tmux to create isolated terminal sessions for each agent
• git worktrees to isolate codebases so each session works on its own branch
• A text-based UI to navigate and manage sessions

Getting started

Installation options:

• Homebrew: brew install claude-squad followed by ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
• Manual: curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash (puts cs in ~/.local/bin)

To use a custom binary name: curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name <your-binary-name>

Prerequisites include tmux and gh (GitHub CLI).

Usage:

cs [flags]
cs [command]

Commands include: completion, debug, help, reset, version. Flags include an experimental auto-accept mode -y/--autoyes, and -p/--program to specify a program for new sessions.

Run: cs

The default program is claude.

Using Claude Squad with other assistants:

• Codex example: cs -p "codex"
• Aider example: cs -p "aider ..."
• Gemini: cs -p "gemini"

Configuration is stored at ~/.claude-squad/config.json.

Profiles allow multiple named program configurations within the config file. Each profile has name and program fields. If no profiles are defined, Claude Squad uses default_program directly as the launch command (default is claude).

FAQs: If starting a new session fails with a timeout, update the underlying program (e.g., claude) to the latest version.

How It Works (summary): tmux for isolated sessions, git worktrees for isolated codebases, and a simple TUI for navigation.