Briareus

The hundred-handed titan — orchestrate parallel Claude Code instances.

Turn one Claude into a team. Briareus decomposes complex tasks into parallel subtasks, spawns isolated Claude Code workers, and merges everything back automatically.

Quick Start

# Build container
docker compose build

# Initialize in your project
docker compose run briareus init

# Generate a plan
docker compose run briareus plan "implement auth system with JWT"

# Execute with 6 parallel workers
docker compose run briareus run -w 6

# Monitor status
docker compose run briareus status

# Merge results
docker compose run briareus collect

# Clean up
docker compose run briareus cleanup

How It Works

1. Plan — Claude decomposes your task into parallel subtasks with dependency DAG
2. Spawn — Each task gets an isolated git worktree + dedicated Claude instance
3. Monitor — Rich live dashboard shows progress, cost, and activity per worker
4. Collect — Branches merge back to main with conflict detection

Configuration

Edit briareus.yaml:

max_workers: 4          # parallel claude instances
model: sonnet           # default model (sonnet/opus/haiku)
max_budget_usd: 2.0     # per-worker budget
total_budget_usd: 20.0  # total swarm budget
base_branch: main       # branch to fork from

Local Install (without Docker)

pip install -e .
briareus init
briareus plan "your task"
briareus run