cloudcli

A fast, scriptable CLI for the VeloDB / SelectDB Cloud control plane. It manages warehouses, clusters, networking, billing, and audit logs over the VeloDB Cloud Management API v1 and returns structured JSON. It does not run SQL — data-plane work (queries, loads, tablet/profile inspection) is handed off to its sibling doriscli.

Install

npm install -g @data-cloud-tools/cloudcli
cloudcli --version

This package ships a prebuilt native binary. On install, npm automatically pulls only the platform package that matches your OS + CPU (via optionalDependencies

• os/cpu constraints), so there is no compile step and no Rust toolchain needed.

Supported platforms: macOS (arm64), Linux (x64, arm64). On any other platform, build from source.

Quick start

# Register an environment with your Cloud Management API key. auth add probes the
# API and, if your org has exactly one warehouse and cluster, picks them as the
# current context automatically.
cloudcli auth add prod --api-key sk-xxxxxxxx --api-host api.velodb.cloud

# Confirm the key works and see what context was picked.
cloudcli auth status
cloudcli cloud ctx

# Explore the control plane.
cloudcli cloud warehouse ls
cloudcli cloud cluster ls

See the full documentation for warehouses, clusters, endpoints, public-access, privatelink, billing, and audit.

License

Proprietary software, distributed under npm's UNLICENSED (all rights reserved); not open source.