Claude Squad

Claude Squad launches 4 concurrent Claude Code remote control sessions in named tmux sessions (alpha, beta, gamma, delta). Each session runs claude --dangerously-skip-permissions rc, generating a session URL controllable from the Claude phone app.

Why tmux?

tmux provides persistent terminal sessions that survive disconnects. Each Claude RC session runs inside its own tmux session, which means:

• Sessions persist even if you close your browser or lose connection
• Output can be captured programmatically (tmux capture-pane) for monitoring
• Sessions can be controlled by sending keystrokes (tmux send-keys)
• Multiple sessions coexist independently without interfering with each other

Architecture

┌─────────────────────────────────────────────────┐
│  Adom Container                                  │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│  │  tmux    │  │  tmux    │  │  tmux    │  │  tmux    │
│  │  alpha   │  │  beta    │  │  gamma   │  │  delta   │
│  │          │  │          │  │          │  │          │
│  │ claude   │  │ claude   │  │ claude   │  │ claude   │
│  │ --skip   │  │ --skip   │  │ --skip   │  │ --skip   │
│  │ rc       │  │ rc       │  │ rc       │  │ rc       │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘
│       │              │              │              │
│       └──────────────┴──────┬───────┴──────────────┘
│                             │
│  ┌──────────────────────────┴───────────────────┐
│  │  Gallia Viewer (GV)                           │
│  │  - Live status dashboard                      │
│  │  - Start / Restart / Stop controls            │
│  │  - Watchdog auto-restart (15s interval)       │
│  │  - Per-session chat output viewer             │
│  │  - Auto-start on boot                         │
│  └───────────────────────────────────────────────┘
│                             │
└─────────────────────────────┼───────────────────┘
                              │
                    ┌─────────┴─────────┐
                    │  Claude Phone App  │
                    │  (Remote Control)  │
                    └───────────────────┘

Gallia Viewer Dashboard

The squad has a full management UI built into Gallia Viewer. Features include:

• Live status — green/yellow/red indicator showing how many sessions are running, auto-refreshes every 5 seconds
• Start / Restart / Stop — buttons to launch all 4 sessions, restart the entire squad, or stop everything
• Per-session restart — click the restart icon on any card to restart just that session
• Chat output — click a session card to view its full tmux pane output (last 1000 lines), auto-scrolls to bottom
• Watchdog — toggle to auto-restart any dead sessions every 15 seconds; shows restart count and recent restart log
• Start on boot — checkbox (default ON) that auto-launches the squad when the GV server starts
• Explainer tooltip — hover the ? icon for a quick overview of why tmux is used

Phone App Experience

On the Claude phone app, each RC session appears as "Remote Control session" with the container ID. Currently the Claude CLI rc subcommand doesn't support custom session naming, so all 4 sessions look identical on the phone — differentiated only by their start timestamp. The GV dashboard compensates by clearly labeling each channel (Alpha, Beta, Gamma, Delta) with color-coded badges.

Session Naming

Sessions use the pattern {repo}-{greek}:

The repo name is derived from the container's VSCODE_PROXY_URI environment variable.

Commands

Capabilities

• Launch 4 concurrent Claude Code RC sessions in one click
• Monitor session status with color-coded cards (green = running, red = dead)
• View live chat output from any session
• Auto-restart dead sessions with built-in watchdog (15-second check interval)
• Auto-launch squad on container boot (configurable)
• Restart individual sessions without affecting others
• Send prompts to sessions via tmux
• Full programmatic API via WebSocket and HTTP