How It Works
From ticket to PR,
on machines you control.
Install the CLI, register a worker, ship work. The orchestrator watches — you stay in control.
Visualize your AI infrastructure — live. Click around to see how it works.
⌘+scroll to zoom · drag to pan · click a star
The Flow
Ticket in. PR out.
Get a worker
Your machine or a Cloud worker — one CLI command connects it.
Add your AI agent
Build a DevBox image with Claude Code, Copilot, or Codex — your own key.
Ship work
Paste a ticket URL — or run on a schedule. DevBoxes spin up automatically.
Review the run
Run completes — you're notified in-app and by email. Review the agent's commits and any PRs it opened, then merge.
Getting Started
CLI first. Browser second.
The clustercode CLI is where you start — it handles login, health checks, and worker registration. The orchestrator dashboard is where you watch, manage, and iterate.
Install the CLI
30 seconds. Node.js 18+ required.
The ClusterCode CLI is your entry point — it handles login, worker registration, onboarding, and health checks. Install it globally once.
npm install -g @clustercode/cli
clustercode --version # 0.1.0
Run doctor
Verify your environment before doing anything else.
The doctor command checks everything ClusterCode needs: authentication, worker configuration, container runtime (Podman or Docker), and connectivity to the orchestrator. If anything fails, clustercode onboard walks you through fixing it interactively — including installing Podman, configuring WSL2 on Windows, and selecting your tenant.
clustercode doctor
✓ Logged in as you@example.com ✓ Worker registered (My Team) ✓ Podman 5.1.0 — running ✓ Orchestrator reachable (console.clustercode.io)
Register a worker
Any machine with Podman or Docker. Mac, Linux, or Windows.
After login, clustercode worker starts the worker agent on this machine — it connects outbound to the orchestrator over a WebSocket, so no inbound ports or firewall rules are needed. Prefer not to use your own hardware? Provision a Cloud worker from the dashboard instead — it connects the same way, you just don't manage the machine.
# Log in first (opens browser for OAuth) clustercode login # Start the worker on this machine clustercode worker
Starting worker... ✓ Connected to console.clustercode.io ✓ Worker "my-laptop" online
Build a DevBox image
Done through the UI. Pick your engines. Pro+ unlocks full customisation.
Open Dashboard → Images → Build. Choose a target worker (BYOM or Cloud), select Linux or Windows, and pick which AI engines to include — Claude Code, GitHub Copilot, or Codex. Each engine uses your own API key; nothing is bundled. Pro+ users unlock the Advanced section: add language runtimes, toggle extra dev tools, supply a custom base image, or inject arbitrary Containerfile instructions. Hit Build. The image compiles on the worker and appears in your image list within a few minutes — ready for Agent Runs and Schedules.
Ship work
One-off Agent Run, or automated with Schedules + Nova Autopilot.
Paste a ticket URL in the dashboard and hit Run — a DevBox spins up, the AI agent gets full ticket context, and starts coding. Watch it work in the live terminal. You can type corrections, check test output, or close the browser — the DevBox keeps running, and the agent's session is still there when you come back, from any machine. Your logins travel with you too — every DevBox comes up already authenticated, on any machine. Or take the other path: launch a DevBox on its own. Same machine, same ticket context, agent CLI installed — but nothing runs until you start the agent yourself in the terminal. A launch gives you the machine; a Run gives you the result. For automated overnight work: configure a Schedule with Nova Autopilot to query your ticket board for "Ready for Dev" items and launch DevBoxes for each one automatically.
Review the run
Notified in-app + by email. Agent's work is in your repo.
When the run completes, ClusterCode marks it finished and sends you an in-app notification and an email. The agent worked autonomously inside the DevBox — reading the ticket, writing and testing code, committing changes. If it opened a pull request (via git push), you'll find it waiting in your repo. Review the commits and any PRs the agent opened. Merge what looks good. The DevBox shuts down automatically when the run ends, freeing the worker for the next task.
Architecture
Three layers. One flow.
Orchestrator— ClusterCode’s hosted brain. The dashboard you log into at console.clustercode.io. Manages workers, DevBox images, schedules, and Nucleus — the conversational fleet manager you can simply ask (“launch a DevBox for ticket #55”). You don’t self-host it — we run it for you.
Workers — lightweight agents running on machines you control (or our Cloud workers). They connect outbound to the orchestrator over WebSocket — no inbound ports, no firewall changes. One CLI command starts them.
DevBoxes — isolated environments that Workers launch. Each DevBox gets the full ticket context, the AI agent, and your tools. They orbit the worker in the Observatory, pulsing while the agent works.
Ready to ship your first run?
Register your worker in under 5 minutes. clustercode doctor tells you if anything needs fixing before you start.