Cluster Build

Cluster Build (cluster) is an AI-powered CLI for coding, building, and orchestrating cloud dev environments directly from your terminal. It pairs a rich terminal UI with tool execution — so the AI can read and edit files, run commands, search your codebase, and drive a headless browser on your behalf.

Key Features

• Terminal UI — Interactive TUI built with Bubble Tea for long-form sessions
• Tool Execution — AI can run bash, edit files, grep/glob, fetch web pages, and more — with per-command approval by default
• Remote Builds — Offload work to a provisioned VM and stream results back
• Multi-Provider LLMs — Anthropic, OpenAI, and Google Vertex via the Fantasy framework
• Sessions — Resume the last session or attach to an in-progress remote build
• Git Worktrees — Spin up a session in an isolated worktree to keep changes off your main branch

How It Works

cluster runs locally and connects to the Build API server, which brokers LLM calls and executes remote tools. When you start a session, the TUI opens and you can chat, request edits, or kick off a multi-step task.

# Start an interactive session in the current directory
cluster

# Resume the last session
cluster --resume

# Run a session inside a new git worktree
cluster --worktree feature-xyz

How the pieces fit

• The cluster CLI runs locally and hosts the TUI, session state, and tool approval flow.
• The Build API runs on Cluster's infrastructure and brokers LLM calls across Anthropic, OpenAI, and Google Vertex. It also hosts the server-side tools used in remote builds.
• Authentication is handled through your Cluster account.

Communication between the CLI and Build API uses HTTP with Server-Sent Events for streamed agent output.