Command Reference
Explore the comprehensive command set available in the machine CLI client.
Below is the complete list of developer commands supported by the BlueMachine client. Commands can be run interactively or customized using command-line flags.
| Command | Arguments & Flags | Description |
|---|---|---|
| login | None | Authenticates the CLI using safe browser-based redirects. |
| logout | None | Clears locally stored API tokens and session data. |
| whoami | None | Shows authenticated account, active plan, and credit usage details. |
| run <cmd> | -c, --class <slug> -t, --ttl <mins> --dir <path> --no-sync | Core command. Leases a VM, syncs local files, executes the command, streams output, and tears down the VM. |
| ls | None | Lists all active VM leases, showing status, IPs, and expiry timers. |
| status <id> | <run-id> | Retrieves execution stats, duration, and exact cost of a past run. |
| logs <id> | <run-id> -f, --follow | Fetches or streams real-time console logs for an active run. |
| stop <id> | <lease-id> | Manually terminates and deletes an active VM lease early. |
✦Interactive Selection
If you omit the --class parameter when executing 'machine run', the CLI will present a terminal menu allowing you to choose your desired CPU or GPU tier class interactively.
STATUS // BETADOCS.BLUEMACHINE