ClaudeMap

Claude Squad

Manage multiple AI terminal agents (Claude Code, Codex, Gemini, Aider) in parallel tmux sessions.

Plugins & Agentsterminaltmuxparallel-agentsworktrees
Visit projectsmtg-ai/claude-squad

A terminal UI (`cs` command) that runs several AI coding agents side by side, each in its own tmux session and isolated git worktree. You can watch all agents' progress at a glance, jump into any session, and merge whichever branch finishes best. The practical answer to 'can I run more than one Claude Code at once?'

What it does

  • Each agent gets its own tmux session and isolated git worktree — parallel tasks never collide, and one TUI shows every session's progress
  • Review diffs before applying them, checkout changes before pushing; experimental -y auto-accept for hands-off runs
  • Profiles: named program configurations (claude, codex, aider --model ...) switchable in the session-creation picker
  • Works beyond Claude: cs -p "codex", "aider ..." or "gemini", or change the default in ~/.claude-squad/config.json

When to use it

The practical answer to running more than one agent at once: two features in parallel, a refactor here and a bugfix there, each in its own worktree. Also a low-cost way to trial competing agents (Claude Code vs Codex vs Aider) on the same codebase without uninstalling anything.

Getting started

brew install claude-squad, then symlink the binary:

ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"

or:

curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash

Prerequisites: tmux and the GitHub CLI (gh).

Things to know

AGPL-3.0. Repo activity has quieted — last push August 2026 per the GitHub API (checked 2026-10-17) — so expect slow fixes. If a new session times out waiting for tmux, the README's first remedy is updating the underlying agent (e.g. claude) to the latest version.

Repository

smtg-ai/claude-squad

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
    View

  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
    View

  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md
    View