Claude Squad — Manage Multiple AI Agent Sessions

What is Claude Squad?

Claude Squad is a terminal multiplexer for AI coding agents. It lets you run multiple Claude Code, Aider, or Codex sessions in parallel — each in its own git worktree — with a unified dashboard showing status, diffs, and session management. Think of it as tmux for AI agents.

Answer-Ready: Claude Squad is a terminal multiplexer that manages multiple AI coding agent sessions (Claude Code, Aider, Codex) in parallel with tmux-based management, git worktree isolation, and a unified status dashboard. 5k+ GitHub stars.

Best for: Developers running multiple AI coding tasks simultaneously. Works with: Claude Code, Aider, Codex CLI, any terminal-based agent. Setup time: Under 2 minutes.

Core Features

1. Multi-Session Dashboard

┌─────────────────────────────────────────────┐
│ Claude Squad                                │
├─────┬──────────────┬────────┬───────────────┤
│  #  │ Session      │ Status │ Changes       │
├─────┼──────────────┼────────┼───────────────┤
│  1  │ auth-refactor│ Active │ +142 -38      │
│  2  │ add-tests    │ Paused │ +89 -12       │
│  3  │ fix-bug-123  │ Done   │ +15 -3        │
│  4  │ new-feature  │ Active │ +201 -0       │
└─────┴──────────────┴────────┴───────────────┘

2. Git Worktree Isolation

Each session gets its own git worktree — no branch conflicts:

main repo/
├── .worktrees/
│   ├── auth-refactor/    # Session 1
│   ├── add-tests/        # Session 2
│   ├── fix-bug-123/      # Session 3
│   └── new-feature/      # Session 4

3. Session Controls

4. Agent Agnostic

Works with any terminal-based AI agent:

# Default: Claude Code
claude-squad

# Use Aider
claude-squad --agent aider

# Use Codex
claude-squad --agent codex

# Custom command
claude-squad --agent "python my_agent.py"

5. Diff Preview

View changes from any session without attaching:

Press 'd' on a session to see:
  src/auth/middleware.ts  | +42 -8
  src/auth/types.ts      | +15 -0
  tests/auth.test.ts     | +85 -30

Workflow Example

# Start Claude Squad
claude-squad

# Session 1: "Refactor the auth module"
# Session 2: "Add unit tests for the payment service"
# Session 3: "Fix the date parsing bug in issue #123"

# All three run in parallel, each in isolated worktrees
# Review diffs, merge when ready

FAQ

Q: Does it work with Claude Code? A: Yes, Claude Code is the default agent. Just launch claude-squad.

Q: Can sessions access each other's changes? A: No, each session runs in an isolated git worktree. Changes only merge to main when you explicitly merge.

Q: System requirements? A: Requires tmux and git. Works on macOS and Linux.