CLI Overview

The clustercode CLI manages workers, authentication, and configuration from your terminal.

Install

The CLI is published to the GitHub Package Registry. Configure the scope, then install:

npm config set @clustercode:registry https://npm.pkg.github.com
npm install -g @clustercode/cli

Commands

Command	Description
clustercode login	Authenticate via browser OAuth or API token
clustercode worker	Configure tenant and start the worker
clustercode doctor	Check system health
clustercode onboard	Guided setup wizard
clustercode config	Manage CLI configuration
clustercode status	Show current state

Global Behavior

• All commands read configuration from ~/.clustercode/config.json
• Credentials are stored in ~/.clustercode/credentials.json
• Worker identity is stored in ~/.clustercode/worker.json

Configuration Directory

~/.clustercode/
├── credentials.json    # API key + email from login
├── worker.json         # Worker ID, tenant, orchestrator URL
└── config.json         # User preferences (e.g. WORKER_NAME)