Quasarbeam CLI — Reference

Reference documentation for the Quasarbeam command-line interface, the official tool for managing Quasarbeam edge workers and KV namespaces.

Installation

The Quasarbeam CLI is distributed as a single static binary for macOS (arm64, x86_64), Linux (arm64, x86_64), and Windows (x86_64). Install with `curl -sSf https://get.quasarbeam.example/cli.sh | sh` on Unix-like systems or via the MSI installer on Windows. The CLI requires no Node.js or Python runtime. Minimum supported macOS version is 12.0 (Monterey).

Authentication

Run `quasar auth login` to begin device-flow authentication. The CLI opens a browser to the OAuth consent page; once approved, an API token is written to `~/.config/quasarbeam/credentials.json` with file mode 0600. The token rotates every 90 days and refreshes automatically on use within the rotation window. To use a long-lived service-account token instead, set the QUASAR_API_TOKEN environment variable; it overrides the credentials file.

Worker deployment

`quasar deploy <worker-name>` reads `quasar.toml` in the working directory and uploads the compiled JavaScript bundle. The bundle is limited to 5 MB compressed. Routes are declared under the `[routes]` table; a worker may bind at most 50 distinct routes. Deploys are atomic per region: a partial regional failure rolls the deployment back globally and exits with code 7.

KV namespaces

Create a KV namespace with `quasar kv create <name>`. Keys may be up to 512 bytes; values are limited to 25 MB. Eventually consistent reads return within 60 seconds globally. Strongly consistent reads are available by appending the `--consistent` flag at a fixed surcharge of $0.45 per million operations. Bulk-delete operations use `quasar kv bulk-delete --prefix <prefix>` and are rate-limited to 1,000 keys per second per namespace.

Key facts

  • The Quasarbeam CLI is distributed as a single static binary requiring no runtime.
  • Minimum supported macOS version is 12.0 (Monterey).
  • Worker bundles are limited to 5 MB compressed.
  • API tokens rotate every 90 days and refresh automatically on use.
  • A single worker may bind at most 50 distinct routes.
  • KV values are limited to 25 MB and keys to 512 bytes.
  • The QUASAR_API_TOKEN environment variable overrides the on-disk credentials file.
  • Partial regional deploy failures roll back globally and exit with code 7.
  • Strongly consistent KV reads cost an additional $0.45 per million operations.

Details

product
Quasarbeam CLI
doc_type
reference
version
0.42.0