Overview
Cluster Build is an AI coding assistant in your terminal — chat with a model that reads and edits your files, runs commands, and searches your code, with cloud planning and review when you need it.
Cluster Build
Cluster Build is a terminal AI coding assistant. You chat with a model — Claude or
GPT — that can read and edit files in your project, run shell commands, and search
your codebase, all from one command: cluster.
It talks to Cluster's hosted agent gateway, so there are no API keys to manage: you
sign in with your Cluster account and start working.
Everything it stores — config, sessions, and your sign-in — lives under
~/.cluster/.
Most of the time Cluster Build runs locally in your terminal. When a task is
bigger than one machine, it also reaches into the cloud: /ultraplan plans
against your repos on a remote VM, and /ultrareview runs a fleet of review agents
over your changes. See Cloud features.
Install
curl -fsSL https://assets.cluster.app/serve/cstatic-assets/releases/cli/install.sh | shThis installs the cluster binary to a user-writable directory on your PATH
(typically ~/.local/bin) so it can keep itself up to date; set INSTALL_DIR to
choose another location. Confirm it's on your PATH:
cluster --versionThen sign in:
cluster loginThe quickstart walks through your first session end-to-end.
What the assistant can do
The model has a built-in toolset scoped to your current directory:
- Run shell commands — including long-running background processes
- Read files — by line range, byte range, or surrounding code block
- Search — list directories, find files by name or path, and grep across your codebase
- Edit files — apply patches and write changes
- Track a plan — for multi-step work, maintain a visible task checklist that updates as steps move from pending to in progress to complete
Before any change that touches your files, the assistant asks for approval. Read-only actions run without prompting. See Interactive sessions for approvals, plan mode, and the full slash-command reference.
Where things live
Everything Cluster Build stores is under ~/.cluster/:
| Path | Contents |
|---|---|
config.toml | Your settings — model, reasoning effort, and more |
auth.json | Your sign-in token (created by cluster login) |
sessions/ | Saved conversations you can resume |
skills/ | Your custom skills |
Next steps
- Quickstart — install, log in, and run your first task.
- Interactive sessions — the TUI, tools, approvals, plan mode, and slash commands.
- Exec & sessions — run prompts non-interactively and manage saved sessions.
- Models & configuration — pick a model, set
reasoning effort, and tune
config.toml. - Cloud features — remote planning with
/ultraplanand cloud code review with/ultrareview.