https://github.com/smtg-ai/claude-squad
Manage multiple AI agents like Claude Code and Aider. 10x your productivity
https://github.com/smtg-ai/claude-squad
aider claude-code cli vibe-coding
Last synced: 2 months ago
JSON representation
Manage multiple AI agents like Claude Code and Aider. 10x your productivity
- Host: GitHub
- URL: https://github.com/smtg-ai/claude-squad
- Owner: smtg-ai
- License: agpl-3.0
- Created: 2025-03-09T20:00:41.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-05T18:30:38.000Z (3 months ago)
- Last Synced: 2025-04-06T10:09:55.201Z (3 months ago)
- Topics: aider, claude-code, cli, vibe-coding
- Language: Go
- Homepage:
- Size: 3.01 MB
- Stars: 316
- Watchers: 5
- Forks: 21
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome - smtg-ai/claude-squad - Manage multiple AI agents like Claude Code, Aider, Codex, OpenCode, and Amp. (Go)
- awesome-claude-code - `Claude Squad` - ai](https://github.com/smtg-ai) (Tooling)
README
# Claude Squad [](https://github.com/smtg-ai/claude-squad/actions/workflows/build.yml) [](https://github.com/smtg-ai/claude-squad/releases/latest)
Claude Squad is a terminal app that manages multiple Claude Code (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
### Highlights
- Complete tasks in the background (including yolo / auto-accept mode!)
- Manage instances and tasks in one terminal window
- Review changes before applying them, checkout changes before pushing them
- Each task gets its own isolated git workspace, so no conflicts
https://github.com/user-attachments/assets/aef18253-e58f-4525-9032-f5a3d66c975a
### Installation
The easiest way to install `claude-squad` is by running the following command:
```bash
curl -fsSL https://raw.githubusercontent.com/stmg-ai/claude-squad/main/install.sh | bash
```
This will install the `cs` binary to `~/.local/bin` and add it to your PATH. To install with a different name, use the `--name` flag:
```bash
curl -fsSL https://raw.githubusercontent.com/stmg-ai/claude-squad/main/install.sh | bash -s -- --name
```
Alternatively, you can also install `claude-squad` by building from source or installing a [pre-built binary](https://github.com/smtg-ai/claude-squad/releases).
### Prerequisites
- [tmux](https://github.com/tmux/tmux/wiki/Installing)
- [gh](https://cli.github.com/)
### Usage
```
Usage:
cs [flags]
cs [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
debug Print debug information like config paths
help Help about any command
reset Reset all stored instances
version Print the version number of claude-squad
Flags:
-y, --autoyes [experimental] If enabled, all instances will automatically accept prompts for claude code & aider
-h, --help help for claude-squad
-p, --program string Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b')
```
Run the application with:
```bash
cs
```
To use a specific AI assistant program:
```bash
cs -p "aider --model ollama_chat/gemma3:1b"
```
or modify the `config` file (path can be found by running `cs debug`).
#### Menu
The menu at the bottom of the screen shows available commands:
##### Instance/Session Management
- `n` - Create a new session
- `N` - Create a new session with a prompt
- `D` - Kill (delete) the selected session
- `↑/j`, `↓/k` - Navigate between sessions
##### Actions
- `↵/o` - Attach to the selected session to reprompt
- `ctrl-q` - Detach from session
- `s` - Commit and push branch to github
- `c` - Checkout. Commits changes and pauses the session
- `r` - Resume a paused session
- `?` - Show help menu
##### Navigation
- `tab` - Switch between preview tab and diff tab
- `q` - Quit the application
- `shift-↓/↑` - scroll in diff view
### How It Works
1. **tmux** to create isolated terminal sessions for each agent
2. **git worktrees** to isolate codebases so each session works on its own branch
3. A simple TUI interface for easy navigation and management
### License
[AGPL-3.0](LICENSE.md)