Skip to main content
Every command below takes the global options.

trial show

Show one trial in full detail: its status, reward, tokens, spent and spent (judge) rows, gpu compute (est.) on a GPU trial, the exception when it failed, and its latest analysis with the verdicts, the summary and the typed failure. An uploaded trial prints its provider as ported and its reported figures apart from the metered ones. There is no trial files or trial read verb; listing and reading a trial’s stored files is SDK-only, trials().files() and file().

trial trace

Print a trial’s parsed trace, filtered server-side.
event-type
Only events of exactly this type. At most 100 characters.
pattern
Only events matching this case-insensitive regex over type and content. A plain string is a plain substring. At most 512 characters; an invalid pattern is refused by the server with invalid_input.
n
Only the last N matching events, 1 to 10000, then paged oldest first.
seq
Resume after this sequence number. The filters compose with it.
n
default:"200"
Events per page fetch, not a total: the command drains the filtered trace. Max 1000.

trial download

Save a trial as its trial tree plus evolve.json, or stream one artifact to stdout. The two modes are exclusive.
dir
default:"trials/"
Directory to save under. Files land in <dir>/<trial-id>/.
Replace an existing <dir>/<trial-id>/.
artifact
Print one artifact to stdout instead of saving: trace-parsed, verifier, trace-stdout, trace-stderr, trace-atif (the ATIF trajectory), trajectory (reserved: the harness-native session file) or agent-home.
seq
With --stream trace-parsed: resume after this sequence number.
n
With --stream trace-parsed: max events per page.

trial retry

Run one settled trial again. The result is a job.

trial regrade

Verifier-only re-run of one trial. The result is a job.

trial stop

Stop in-flight trials without cancelling their job.

Global options

Machine-readable JSON output.
key
API key. Defaults to $EVOLVE_API_KEY.
url
API base URL. Defaults to the Evolve dashboard API.