https://github.com/theaustinhatfield/claude-code-splitter
🔀 Run 4 Claude Code AI agents in parallel. Multiply your productivity.
https://github.com/theaustinhatfield/claude-code-splitter
ai-agents anthropic claude-code cli coding-assistant developer-tools multi-agent productivity terminal tmux
Last synced: about 2 months ago
JSON representation
🔀 Run 4 Claude Code AI agents in parallel. Multiply your productivity.
- Host: GitHub
- URL: https://github.com/theaustinhatfield/claude-code-splitter
- Owner: theaustinhatfield
- License: mit
- Created: 2025-12-06T06:23:06.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-12-07T01:32:28.000Z (5 months ago)
- Last Synced: 2025-12-10T00:13:41.535Z (5 months ago)
- Topics: ai-agents, anthropic, claude-code, cli, coding-assistant, developer-tools, multi-agent, productivity, terminal, tmux
- Language: HTML
- Size: 74.2 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Code Splitter
One command to launch parallel AI coding agents in a tiled terminal.
```bash
curl -sSL https://raw.githubusercontent.com/theaustinhatfield/claude-code-splitter/main/install.sh | bash
```
Then type `claude4`, `opencode4`, `aider2 gh2`, or any combo to start.
---
```
╦ ╔╗╔ ╔═╗ ╔╦╗ ╔═╗ ╦ ╦ ╦ ╦ ╔═╗ ╦ ╦ ╦═╗ ╔═╗ ╔═╗ ╔═╗ ╔╗╔ ╔╦╗ ╔═╗
║ ║║║ ╚═╗ ║ ╠═╣ ║ ║ ╚╦╝ ║ ║ ║ ║ ╠╦╝ ╠═╣ ║ ╦ ║╣ ║║║ ║ ╚═╗
╩ ╝╚╝ ╚═╝ ╩ ╩ ╩ ╩═╝╩═╝ ╩ ╚═╝ ╚═╝ ╩╚═ ╩ ╩ ╚═╝ ╚═╝ ╝╚╝ ╩ ╚═╝
```
```
┌─────────────────────────────────────────────────────────────────┐
│ │
│ CLAUDE CODE │
│ curl -fsSL https://claude.ai/install.sh | bash │
│ Alt: brew install --cask claude-code │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ OPENCODE │
│ curl -fsSL https://opencode.ai/install | bash │
│ Alt: npm install -g opencode-ai │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ AIDER │
│ pip install aider-chat │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ GEMINI CLI │
│ npm install -g @google/gemini-cli │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ QWEN CODE │
│ npm install -g @qwen-code/qwen-code@latest │
│ Alt: brew install qwen-code │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ OPENAI CODEX │
│ npm install -g @openai/codex │
│ Alt: brew install codex │
│ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ GITHUB CLI │
│ brew install gh │
│ Alt: sudo apt install gh │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---
```
╦ ╦ ╔═╗ ╔═╗ ╔═╗ ╔═╗
║ ║ ╚═╗ ╠═╣ ║ ╦ ║╣
╚═╝ ╚═╝ ╩ ╩ ╚═╝ ╚═╝
```
```bash
claude4 # 4 Claude agents
claude2 aider2 # 2 Claude + 2 Aider
opencode8 # 8 OpenCode agents
gemini2 qwen2 gh2 # mixed swarm
claude100 # infinity mode
```
```
┌──────────── claude ────────────┬──────────── aider ─────────────┐
│ │ │
│ > Building the auth module │ > Fixing the login bug │
│ │ │
├────────── opencode ────────────┼──────────── qwen ──────────────┤
│ │ │
│ > Writing unit tests │ > Updating the docs │
│ │ │
└────────────────────────────────┴────────────────────────────────┘
```
---
```
╔╗╔ ╔═╗ ╦ ╦ ╦ ╔═╗ ╔═╗ ╔╦╗ ╦ ╔═╗ ╔╗╔
║║║ ╠═╣ ╚╗╔╝ ║ ║ ╦ ╠═╣ ║ ║ ║ ║ ║║║
╝╚╝ ╩ ╩ ╚╝ ╩ ╚═╝ ╩ ╩ ╩ ╩ ╚═╝ ╝╚╝
```
```
┌───────────────────┬────────────────────────────────────────┐
│ Select pane │ Click with mouse │
│ Navigate │ Ctrl+B then arrow keys │
│ Fullscreen │ Ctrl+B then Z │
│ Resize │ Drag pane borders │
│ Detach │ Ctrl+B then D │
│ Close pane │ exit or Ctrl+D │
│ Reattach │ tmux attach -t claude-swarm │
│ Kill all │ tmux kill-session -t claude-swarm │
│ Set todo │ todo "fix tests" │
└───────────────────┴────────────────────────────────────────┘
```
---
```
╔╗ ╔═╗ ╔═╗ ╔╦╗ ╔═╗ ╦═╗ ╔═╗ ╔═╗ ╔╦╗ ╦ ╔═╗ ╔═╗ ╔═╗
╠╩╗ ║╣ ╚═╗ ║ ╠═╝ ╠╦╝ ╠═╣ ║ ║ ║ ║ ║╣ ╚═╗
╚═╝ ╚═╝ ╚═╝ ╩ ╩ ╩╚═ ╩ ╩ ╚═╝ ╩ ╩ ╚═╝ ╚═╝ ╚═╝
```
```
┌─ Be specific ────────── "fix the login bug" > "fix the bug"
│
├─ One task per agent ─── Each pane = one focused job
│
├─ Use todo titles ────── todo "auth module" to label panes
│
├─ Mix models ─────────── claude2 aider2 for different strengths
│
├─ Start small ────────── 4 agents first, scale up as needed
│
└─ Detach & reattach ─── Ctrl+B D to background, come back later
```
---
```
╔╦╗ ╦═╗ ╔═╗ ╦ ╦ ╔╗ ╦ ╔═╗ ╔═╗ ╦ ╦ ╔═╗ ╔═╗ ╔╦╗
║ ╠╦╝ ║ ║ ║ ║ ╠╩╗ ║ ║╣ ╚═╗ ╠═╣ ║ ║ ║ ║ ║
╩ ╩╚═ ╚═╝ ╚═╝ ╚═╝ ╩═╝╚═╝ ╚═╝ ╩ ╩ ╚═╝ ╚═╝ ╩
```
**tmux: command not found**
```bash
brew install tmux # Mac
sudo apt-get install tmux # Ubuntu/Debian
```
**duplicate session: claude-swarm**
```bash
tmux kill-session -t claude-swarm
```
**agent: command not found**
1. Install the agent from the table above.
2. Run `source ~/.bashrc` (or `source ~/.zshrc`).
3. Still missing? `export PATH="$PATH:$HOME/.local/bin"` or restart terminal.
**Security** — Only whitelisted CLIs can run. Recursion guard prevents nested swarms.
**Platform** — Mac, Linux, Windows (WSL). Requires `tmux`.
---
```
┌─────────────────────────────────────────────────────────────┐
│ │
│ MIT License │
│ │
│ Created by @theaustinhatfield │
│ github.com/theaustinhatfield/claude-code-splitter │
│ │
└─────────────────────────────────────────────────────────────┘
```