@rotastellar/cli

The developer CLI for RotaStellar — bring your own workload: package your program, push it, run it on the orbital compute fleet, and fetch the results, all from your terminal.

A thin, self-contained wrapper over the authenticated RotaStellar control-plane API. No external dependencies; requires Node ≥ 18.

RotaStellar is in private beta. You'll need an account and an API key — request access at rotastellar.com.

Install

npm install -g @rotastellar/cli

This puts a rotastellar command on your PATH.

Quickstart

# 1. authenticate (stores creds in ~/.rotastellar/config.json)
rotastellar login --key <your-api-key>

# 2. push a workload and run it
rotastellar workload push ./my.wasm --name my-detector --kind eo.triage
rotastellar workload run pkg_xxxxxxxx@1

# …or push + run in one step
rotastellar workload run ./my.wasm --name my-detector

# 3. follow it and fetch results
rotastellar workload results <workload_id>
rotastellar workload results <workload_id> -o ./out      # download result artifacts

Commands

| Command | What it does | |---|---| | rotastellar login --key <api-key> [--url <base-url>] | Save credentials. | | rotastellar workload build <file.wasm> [--kind k] [--caps a,b] | Dry-run: show the content id + manifest locally; nothing is uploaded. | | rotastellar workload push <file.wasm> --name <n> [--kind k] [--caps a,b] | Content-address + register your program. | | rotastellar workload run <package_ref \| file.wasm> [--name n] [--objective o] | Submit a workload. A .wasm path is pushed first, then run. | | rotastellar workload results <workload_id> [-o ./out] | Status, outcome, and result artifacts; -o downloads them. | | rotastellar workload list | List your packages. | | rotastellar workload types | List the valid --kind values and their capabilities. |

Configuration

Credentials live in ~/.rotastellar/config.json (base_url, api_key). You can override per-invocation with environment variables:

| Variable | Overrides | |---|---| | ROTASTELLAR_URL | the control-plane base URL | | ROTASTELLAR_API_KEY | the API key |

Capabilities for a workload are resolved automatically per --kind; override them with --caps a,b.

How it works

The CLI never moves bytes through a browser. push content-addresses your program and uploads it directly to object storage via a short-lived presigned URL; run submits by package reference. The result artifacts are either custodied for you (content-addressed) or delivered to your own sink if you configured one.

Support

• Docs & access: rotastellar.com
• Security reports: see SECURITY.md
• Questions: [email protected]

License

Apache-2.0.