Operate run.cloud Sandboxes

Use the runcloud CLI for terminal and interactive workflows. Use @run-cloud/sdk for TypeScript applications, CI, and agent code.

Authenticate

• Install the CLI with npm install -g runcloud.
• Use runcloud login for an interactive browser handoff. Use runcloud login --manual when a local callback cannot open.
• In CI, set RUN_CLOUD_API_KEY. RUN_CLOUD_API_TOKEN is an equivalent alias.
• Set RUN_CLOUD_API_URL only to override the production default https://api.run.cloud.
• Never print, commit, or place credentials in a skill file.
• Treat signed desktop and tunnel URLs as bearer secrets.
• Require Node.js 20 or newer for the CLI and TypeScript SDK.

Inspect account and organization usage before starting metered work: