scalix-cloud

The official CLI for Scalix Cloud — manage databases, AI, storage, functions, and deployments from your terminal.

npm install -g scalix-cloud
scalix-cloud --version
scalix-cloud login <token>
scalix-cloud db query "select 1"
scalix-cloud fn deploy ./my-function
scalix-cloud run deploy ./my-service

How it works

The CLI is a native Rust binary. This npm package is a thin launcher: on install (and, as a fallback, on first run) it downloads the prebuilt scalix-cloud binary that matches your platform from the corresponding GitHub release, verifies its SHA-256 checksum, and caches it inside the package.

Prebuilt platforms:

| OS | Architectures | |----|---------------| | Linux | x86_64, aarch64 | | macOS | Intel (x86_64), Apple Silicon (aarch64) | | Windows | x86_64 |

Environment variables

• SCALIX_CLOUD_BIN — path to a scalix-cloud binary to use instead of downloading (e.g. a local cargo build -p scalix-cloud-cli build).
• SCALIX_CLOUD_SKIP_DOWNLOAD=1 — skip the postinstall download (the binary is fetched on first run instead).
• SCALIX_CLOUD_DOWNLOAD_BASE — override the release asset base URL (private mirrors).

Release ordering (maintainers)

The npm package version maps to a GitHub release tag (vX.Y.Z) whose assets it downloads. Publish order matters: tag + let the release workflow upload the per-platform binaries first, then npm publish. Publishing npm before the release exists means installs fall back to a first-run download that also can't find the assets yet.

Verification gate (before announcing)

Confirm a clean global install on each platform:

npm install -g scalix-cloud && scalix-cloud --version

Run on macOS (Intel + Apple Silicon), Linux (x86_64 + aarch64), and Windows (x86_64). Each should print the version matching the installed package.

Not to be confused with scalix (Scalix Coder, the AI coding agent).

License

BUSL-1.1 — © Scalix World.