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

## 快速使用

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

启动后按 `n` 创建新 AI 代理会话。

## 什么是 Claude Squad？

Claude Squad 是 AI 编码代理的终端多路复用器。并行运行多个 Claude Code、Aider 或 Codex 会话，每个会话独立 git worktree 隔离。

**一句话总结**：Claude Squad 是终端多路复用器，管理多个 AI 编码代理会话（Claude Code、Aider、Codex），基于 tmux 和 git worktree 隔离，5k+ GitHub stars。

**适合人群**：同时运行多个 AI 编码任务的开发者。**支持**：Claude Code、Aider、Codex CLI。

## 核心功能

### 1. 多会话仪表盘
统一视图显示所有会话状态和变更。

### 2. Git Worktree 隔离
每个会话独立工作树，无分支冲突。

### 3. 代理无关
支持任何终端 AI 代理。

### 4. Diff 预览
不进入会话即可查看变更。

## 常见问题

**Q: 支持 Claude Code 吗？**
A: 支持，Claude Code 是默认代理。

**Q: 会话之间会互相影响吗？**
A: 不会，每个会话在隔离的 git worktree 中运行。

## 来源与致谢

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

---
Source: https://tokrepo.com/en/workflows/935294e1-35a8-47a9-b09b-4c94703d7aa9
Author: Skill Factory