CLI commands

The cloudscode CLI wraps the control-plane API. It’s a thin client; everything it does is also reachable via plain HTTP.

Install

# macOS
brew install cloudscode/tap/cloudscode

# Linux
curl -fsSL https://get.cloudscode.com | sh

# Verify
cloudscode --version

Configure

cloudscode login                          # opens a browser for OAuth
cloudscode config set api-url https://api.cloudscode.com
cloudscode config set tenant ten_01H...   # default tenant for subsequent calls

Configuration is written to ~/.cloudscode/config.toml.

Tenants

cloudscode tenant list
cloudscode tenant create --name acme --plan hobby
cloudscode tenant use ten_01H...
cloudscode tenant invite alice@example.com --role member

Runtime instances

cloudscode instance list
cloudscode instance start --runtime openclaw --image cloudscode/openclaw:latest
cloudscode instance logs <instance_id> --follow
cloudscode instance stop <instance_id>

BYOK

cloudscode byok add anthropic --label prod --key sk-ant-...
cloudscode byok list
cloudscode byok rm <key_id>

Conversations

cloudscode chat <instance_id>             # interactive REPL
cloudscode chat <instance_id> -m "ship the docs site"
cloudscode runs replay <run_id>

Webhooks

cloudscode webhook add https://example.com/hook --events instance.started,conversation.completed
cloudscode webhook list
cloudscode webhook test <webhook_id>      # sends a synthetic event

Self-host helpers

cloudscode self-host doctor               # checks docker, ports, dns, certs
cloudscode self-host upgrade              # pulls latest images, runs migrations

Global flags

Flag	Effect
--tenant <id>	Override the default tenant for one call.
--json	Emit machine-readable JSON instead of tables.
--api-url <u>	Override the configured API URL.
-v, --verbose	Verbose logging (HTTP requests, retries).