Repolode
Submit
smtg-ai

smtg-ai/claude-squad

A terminal app (CLI/TUI) for running and managing multiple AI coding agents like Claude Code, Codex, and Aider in separate git workspaces.

View on GitHubWebsite
Stars
8,645
Forks
625
Open issues
50
Last commit
2 months ago

What is it?

Claude Squad is a terminal application that runs several local AI coding agents at once, including Claude Code, Codex, Gemini, and Aider, each in its own session. It gives developers one terminal window to start, monitor, and switch between tasks, so multiple agents can work in the background at the same time.

Each session is backed by tmux and a separate git worktree on its own branch, so agents editing the same repository do not step on each other's files. From the TUI you can preview a session, inspect its diff, reprompt an agent, commit and push its branch to GitHub, or check out its changes and pause it. The `cs` command can be launched with a custom program, and profiles let you define several named agent configurations to pick from when creating a session.

The tool requires tmux and the GitHub CLI (gh). It is installed via Homebrew or a shell install script.

Key features

  • 01Runs multiple AI agents such as Claude Code, Codex, Gemini, and Aider in parallel sessions.
  • 02Isolates each task in its own git worktree and branch.
  • 03Previews session output and diffs in a terminal UI.
  • 04Commits and pushes a session's branch to GitHub from the interface.
  • 05Supports named profiles for switching between agent launch commands.
  • 06Includes an auto-accept (yolo) mode for running tasks in the background.

Use cases

  • Running several Claude Code or Codex tasks on the same repository at once without branch conflicts.
  • Comparing how different AI coding agents approach the same problem side by side.
  • Reviewing an agent's diff before committing and pushing its branch.

Quick start

  1. 1

    Install via Homebrew

    brew install claude-squad
  2. 2

    Create the short 'cs' alias

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

    Install tmux and gh as prerequisites (see their install pages)

  4. 4

    Run the application

    cs

Things to know

  • Requires tmux and the GitHub CLI (gh) to be installed.
  • Default program is claude, so you need an agent such as Claude Code or another supported tool available.

Topics

#ai-agents#terminal#cli#git-worktree#tmux#claude-code#codex#coding-assistant#opencode#vibe-coding

FAQ

What is claude-squad?
A terminal app (CLI/TUI) for running and managing multiple AI coding agents like Claude Code, Codex, and Aider in separate git workspaces. Claude Squad is a terminal application that runs several local AI coding agents at once, including Claude Code, Codex, Gemini, and Aider, each in its own session. It gives developers one terminal window to start, monitor, and switch between tasks, so multiple agents can work in the background at the same time.
Is claude-squad free to use? What license does it have?
claude-squad is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is claude-squad still maintained?
Updated within 6 months. The last commit to claude-squad was on Aug 20, 2026.
What can I use claude-squad for?
Running several Claude Code or Codex tasks on the same repository at once without branch conflicts. Comparing how different AI coding agents approach the same problem side by side. Reviewing an agent's diff before committing and pushing its branch.
How do I install claude-squad?
Install via Homebrew: brew install claude-squad Create the short 'cs' alias: ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs" Install tmux and gh as prerequisites (see their install pages) Run the application: cs
Where can I get claude-squad?
The source code and installation instructions are on GitHub: https://github.com/smtg-ai/claude-squad

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects