divergent/docs

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
esc