Coliseo CLI

CLI for the Coliseo sandbox control-plane API.

License: Apache-2.0

Install

npm install -g coliseo-cli

Then use:

coliseo --help

One-off execution without a global install:

npx coliseo-cli --help

Auth

The CLI uses https://api.coliseo.io by default. Set an API key:

export SANDBOX_API_KEY="cp_your_api_key"

Use --api-key to pass a key for one command, and --base-url to target another control-plane API.

Examples

coliseo list
coliseo --api-key cp_your_api_key list
coliseo --base-url http://127.0.0.1:3000 --api-key cp_your_api_key list
coliseo create --profile standard --name demo --image base --metadata '{"customer_id":"cus_123"}'
coliseo metadata set sb_123 '{"status":"ready","workflow":{"attempt":1}}'
coliseo exec sb_123 -- uname -a
coliseo connect sb_123
coliseo ports expose sb_123 --port 3000
coliseo env list sb_123
coliseo images create python-api --from python3 --run "pip install flask" --wait

Publish

From cli/ after logging in to npm:

npm publish

prepack runs build, lint, and tests automatically before the tarball is created.