Compute · Commands
div runs
List the org's runs, newest first, with status, hardware, hourly rate and cost.
Synopsis
div runs [flags]
Lists runs across all projects in the org, newest first.
Flags
| Flag | Description | Default |
|---|---|---|
--status <status> |
Only runs with this status. See Statuses. | all |
--project <name> |
Only runs in this project. | all projects |
--limit <n> |
Maximum number of runs. Maximum 500. | 50 |
--json |
Print the runs as a JSON array. | |
--token <key> |
API key to use. | see Configuration |
--api-url <url> |
API URL to use. | see Configuration |
Statuses
| Status | Meaning |
|---|---|
active |
Any run that has not finished: queued, provisioning or running. |
queued |
Waiting for hardware. |
provisioning |
Hardware assigned, starting. |
running |
Running. |
succeeded |
Exited with code 0. |
failed |
Exited with a non-zero code. |
canceled |
Stopped with div stop or from the dashboard. |
budget_exceeded |
Reached its --max-spend limit. |
limit_reached |
Stopped because the org reached its usage limit or ran out of credit. |
Output
One run per line on stdout, with no header: name, status, hardware, hourly rate while running (— once finished), amount spent, duration and project. A summary of what unfinished runs cost per hour goes to stderr.
run-8f2a running 4× H100 $19.80/h $0.33 1m 0s very-cool-classifier
run-k4t9 budget exceeded 1× H100 — $5.00 1h 1m very-cool-classifier
run-q1b7 succeeded 1× H200 — $1.05 10m 35s lora-sweep
1 run active, $19.80 per hour
Exit codes
| Code | Meaning |
|---|---|
0 |
Success, including when no runs match. |
1 |
The API rejected the request. |
2 |
Invalid flags, such as an unknown --status. |
Examples
div runs
div runs --status active
div runs --project very-cool-classifier --limit 10
div runs --status active | cut -d' ' -f1 | xargs -n1 div stop