Quickstart
Install Cluster Build and start your first session in under two minutes.
Quickstart
1. Install
Install Cluster Build with a single command:
curl -fsSL https://assets.cluster.app/serve/cstatic-assets/releases/cli/install.sh | shThis downloads the latest prebuilt binary for your platform and installs it to ~/.local/bin/cluster. Make sure ~/.local/bin is on your PATH.
Verify the install:
cluster version2. Authenticate
Cluster Build uses Supabase for authentication. Log in with your Cluster account:
cluster auth loginCheck your auth status at any time:
cluster auth status3. Start a session
Run cluster in any project directory to start an interactive session:
cd my-project
clusterThe TUI opens and you can start chatting with the agent. Ask it to explore the codebase, fix a bug, or implement a feature — it has tools for reading and editing files, running commands, searching, and more.
4. Common flags
| Flag | Description |
|---|---|
--resume / -r | Resume the last session |
--session-id <id> | Resume a specific session (requires --resume) |
--worktree [name] | Run the session inside a new git worktree |
--dangerously-allow-all | Skip all tool approval prompts (use with care) |
--log-level <level> | Set log level: error, warn, info, debug, audit |