# Claude Squad — Manage Multiple AI Agent Sessions

> Terminal multiplexer for AI coding agents. Run multiple Claude Code or Aider sessions in parallel with tmux-based management, status tracking, and git worktrees.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
go install github.com/smtg-ai/claude-squad@latest
claude-squad
```

Or download from GitHub releases. Launch and press `n` to start a new agent session.

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

| Key | Action |
|-----|--------|
| `n` | New session |
| `Enter` | Attach to session |
| `d` | Detach from session |
| `p` | Pause session |
| `r` | Resume session |
| `x` | Delete session |
| `m` | Merge session to main |

### 4. Agent Agnostic
Works with any terminal-based AI agent:

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

```bash
# 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.

## Source & Thanks

> Created by [smtg-ai](https://github.com/smtg-ai). Licensed under MIT.
>
> [smtg-ai/claude-squad](https://github.com/smtg-ai/claude-squad) — 5k+ stars

<!-- ZH -->


## Quick Start

```bash
go install github.com/smtg-ai/claude-squad@latest
claude-squad
```

After launching, press `n` to create a new AI agent session.

## What is Claude Squad?

Claude Squad is a terminal multiplexer for AI coding agents. Run multiple Claude Code, Aider, or Codex sessions in parallel, each isolated in its own git worktree.

**In one sentence**: Claude Squad is a terminal multiplexer that manages multiple AI coding agent sessions (Claude Code, Aider, Codex) with tmux and git worktree isolation — 5k+ GitHub stars.

**For**: Developers running multiple AI coding tasks simultaneously. **Supports**: Claude Code, Aider, Codex CLI.

## Core Features

### 1. Multi-Session Dashboard
Unified view of all session statuses and changes.

### 2. Git Worktree Isolation
Each session has an independent worktree — no branch conflicts.

### 3. Agent-Agnostic
Works with any terminal AI agent.

### 4. Diff Preview
View changes without entering the session.

## FAQ

**Q: Does it support Claude Code?**
A: Yes — Claude Code is the default agent.

**Q: Do sessions affect each other?**
A: No — each session runs in an isolated git worktree.

## Source & Thanks

> [smtg-ai/claude-squad](https://github.com/smtg-ai/claude-squad) — 5k+ stars, MIT

---
Source: https://tokrepo.com/en/workflows/claude-squad-manage-multiple-ai-agent-sessions-935294e1
Author: Skill Factory