Claude Squad CLI
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
- 8,694 ★ on the repository
- Last commit
- AGPL-3.0
Broad access
Why this level
- Agents can act without confirmation in --autoyes mode
- Commits and pushes branches to the remote repository
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-squadDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Agents can act without confirmation in --autoyes mode
- Commits and pushes branches to the remote repository
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.
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.
Discussion
No questions or reviews yet.
Related
CLI toolsA local dashboard for many Claude Code sessions: each job gets its own context and todo, agents spawn child agents and message each other
A tmux-based TUI that runs Claude Code, Codex and other agents in one list: status, quick prompts, worktrees and diff review
Multi-agent orchestration for Claude Code: teams, roles, autopilot and task routing across skills and subagents
Anthropic's coding agent for the terminal, IDE and GitHub: understands your codebase, runs tasks and handles git
A terminal session manager for Claude Code, Codex, Gemini CLI, OpenCode and other agents: one list with statuses, git worktrees and control from a phone
Workflows for Claude Code: /do, /omo, /bmad-pilot and more commands, with Codex, Gemini or OpenCode writing the code through codeagent-wrapper
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| Claude Squad (this entry) | no | 8,694 | |
| TUIOS | no | 6,196 | a Go terminal multiplexer with tiled panes that shows the state of |
| agtx | no | 1,725 | a Rust terminal task board |
| Agent Deck | no | 1,180 | a terminal session manager for Claude Code |
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.