Skip to main content
Analyze a terminal job’s trial traces against a rubric, server-side. Without --watch the command returns at once with the job block and the hint Follow it with: evolve job show <id>; --json prints the accepted job body. Exit 0 on an accepted wave; with --watch, exit 1 when any analysis failed.

Options

name
default:"openrouter/deepseek/deepseek-v4.1-flash"
Model the analyzer runs. glm-5.3-flash and haiku are alternatives, glm-5.3 escalates, and fireworks/deepseek-v4.1-flash is the same model on its Fireworks route. Must be on the claude roster.
value
Reasoning effort the analyzer runs at. Defaults to the per-model default: high on openrouter/deepseek/deepseek-v4.1-flash, max on glm-5.3-flash.
path
Rubric file: TOML (one [[criteria]] table per criterion), YAML or JSON in the {criteria: [{name, description, guidance}]} shape, parsed at the keyboard with unknown fields refused by name; the server owns the bounds. Defaults to the platform’s analyze rubric, seven criteria with score_is_earned first.
path
Prompt file for the evaluator agent; its text replaces the built-in prompt, with {trial_path}, {task_section} and {criteria_guidance} rendered, {{ and }} writing a literal brace, and an unknown {token} rendering empty. The instructions for writing the result are appended after it. An empty file is refused; there is no length bound. Defaults to the built-in prompt.
provider
Sandbox provider the analyzer runs on. Defaults to daytona.
n
Max concurrent trial analyses, 1 to 150, beneath the organization’s max_concurrent_analyses (fleet default 60). Defaults to the ceiling.
Only analyze passing trials (reward 1.0).
Only analyze failing trials (reward below 1.0, or an exception).
n
Max trials to analyze, after --passing or --failing, in the job’s trial order.
Poll until every analysis settles, then print one row per analyzed trial: the label (custom rubric when there is none), the criterion outcomes, the analyzer’s cost and a summary excerpt, with failed analyses listed below. With --json, NDJSON envelopes: analysis.accepted, analysis.stats per change, analysis.final with the job and the analyzed trials.
With --watch: suppress the progress lines and print the final block only.

Global options

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

Reading analyses back

The analysis group lists, shows, traces and downloads analysis runs.