Claude Squad
A terminal app for running several Claude Code, Codex, Gemini CLI and Aider sessions in parallel, each in its own tmux session and git worktree
Install
brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"Requires tmux and gh. Run cs in the repository root.
This is third-party code. Review the repository files before installing.
What it does
Claude Squad runs agents in isolated tmux sessions and gives each task its own git worktree and branch, so agents do not interfere with each other. One terminal window shows the session list, their output and a diff of changes. You can attach to a session and reprompt, pause it with a commit, resume it, or commit and push the branch to GitHub. Profiles in the config let you choose which agent to launch for a new task.
Who it is for. For developers who hand agents several tasks at once and want to keep them organized.
Good fit when
- You want several agent tasks running in parallel in one repository
- You want to review each task's diff before pushing
- You want to switch between Claude Code, Codex and Aider from one interface
Not a fit when
- You are on Windows without tmux
- You have a single task and no need for separate branches
Example request
Start three Claude Squad sessions: database migration, API tests and a README updateLimitations
Requires tmux and the GitHub CLI gh. The --autoyes auto-accept mode is experimental and lets agents act without confirmation. Codex needs an OpenAI key, which does not work from Russia without a VPN. AGPL-3.0 licensed.
How to disable. Run cs reset to clear stored sessions, then brew uninstall claude-squad or delete the cs binary from ~/.local/bin. Settings live in ~/.claude-squad.
Security check
- Agents can act without confirmation in --autoyes mode
- Commits and pushes branches to the remote repository
README in short
The README presents Claude Squad as a terminal app for several agents in separate workspaces. Install via Homebrew or a script, and the command is cs. It lists flags, keybindings for sessions, diff view, commit and push, plus profile setup for different agents. It is built on tmux, git worktrees and a simple TUI. AGPL-3.0 licensed.
FAQ
How do I run another agent instead of Claude Code?
Use -p, for example cs -p "codex", or a profile in ~/.claude-squad/config.json.
What if I get a tmux session timeout?
The README suggests updating the agent itself, such as claude, to the latest version.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Anthropic's coding agent for the terminal, IDE and GitHub: understands your codebase, runs tasks and handles git