explaingit

smtg-ai/claude-squad

7,450GoAudience · developerComplexity · 2/5Setup · moderate

TLDR

A terminal dashboard that runs multiple AI coding assistants in parallel, Claude, Codex, Aider, Gemini, each in its own isolated workspace, so you can tackle several tasks at the same time.

Mindmap

mindmap
  root((Claude Squad))
    What it does
      Parallel AI agents
      Terminal dashboard
      Isolated workspaces
    Supported Agents
      Claude Code
      OpenAI Codex
      Aider
      Gemini CLI
    Features
      Session management
      Auto-accept mode
      Diff review
      GitHub push
    Tech
      Go binary
      tmux sessions
      git worktrees
    Install
      Homebrew
      Install script
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run several coding tasks at once with separate AI agents, each working in an isolated copy of your repo using git worktrees

USE CASE 2

Review and approve changes an AI agent made before committing them, all from a single terminal dashboard

USE CASE 3

Set up fully unattended AI sessions that auto-accept changes and push branches to GitHub without interruption

Tech stack

Gotmuxgit

Getting it running

Difficulty · moderate Time to first run · 30min

Requires tmux and the gh CLI installed, each AI assistant also needs its own API key or local install.

In plain English

Claude Squad is a terminal application that lets you run multiple AI coding assistants at the same time, each working on a different task in its own isolated workspace. Instead of switching back and forth between conversations or waiting for one task to finish before starting another, you can have several AI agents running in parallel and check on their progress from a single screen. The tool works with Claude Code, OpenAI Codex, Aider, Gemini CLI, and other terminal-based AI assistants. You pick which assistant to use when starting a session, and you can mix and match: one session might use Claude while another uses Codex. Each session runs inside its own sandboxed copy of your codebase using git worktrees, which means the agents cannot interfere with each other even if they are touching the same project. The interface is a text-based dashboard in your terminal showing all active sessions. Keyboard shortcuts let you create new sessions, attach to one to give it a new instruction, pause and resume sessions, review what changes an agent made before committing them, or push a branch to GitHub. There is also an auto-accept mode that tells agents to proceed without asking for confirmation on each step, useful when you want fully unattended background work. Setup requires two tools already installed on your system: tmux, which handles the isolated terminal sessions, and the gh command-line tool for GitHub integration. Claude Squad itself installs as a small binary called "cs" via Homebrew or a one-line install script. A profiles feature in the config file lets you save different assistant configurations by name so you can quickly pick between them when starting a new session.

Copy-paste prompts

Prompt 1
How do I start a Claude Squad session that runs Claude Code and Aider in parallel on the same project using git worktrees?
Prompt 2
Show me how to use Claude Squad's auto-accept mode to run an AI agent unattended and push the result to GitHub
Prompt 3
How do I set up named profiles in Claude Squad so I can quickly switch between Claude and Gemini CLI configurations?
Prompt 4
What are the keyboard shortcuts in Claude Squad for creating a new session, switching between agents, and reviewing diffs before committing?
Open on GitHub → Explain another repo

← smtg-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.