evolve analysis

Use evolve analyze to start analyses. Use evolve analysis to read them. First, list the runs:

evolve analysis list --json

Copy an analysis ID into $ANALYSIS_ID, then read its result:

evolve analysis show "$ANALYSIS_ID"

To start a new analysis, use evolve analyze.

List analyses

evolve analysis list --status failed --scope org

Option	Meaning
`--job <job-id>`	Analyses for this job.
`--status <statuses>`	Comma-separated `queued`, `running`, `completed`, or `failed`.
`--scope <my\|shared\|org>`	Records to list. Default `my`.

For --job, use the job ID from evolve job list. All shared list options apply: --limit, --cursor, --columns, --quiet, --no-trunc, --no-headers.

Show the result

evolve analysis show "$ANALYSIS_ID" --json

show, trace, and download also accept a trial ID, which selects that trial’s latest analysis. An analysis ID selects that specific run. Prefixes must identify only one analysis or analyzed trial. Use a full ID when a prefix is ambiguous.

Read the transcript

evolve analysis trace "$ANALYSIS_ID"
evolve analysis trace "$ANALYSIS_ID" --since 200

--since <n> skips N transcript events. This command reads the available transcript and exits; it does not follow live output. With --json, events are printed one per line.

Download

evolve analysis download "$ANALYSIS_ID" -o analyses/

The archive contains the analyzer’s run in a Harbor-compatible trial folder, plus an evolve.json record.

Option	Meaning
`-o`, `--output-dir <dir>`	Parent folder. Default `analyses/`.
`--overwrite`	Allow replacing an existing folder.
`--stream <artifact>`	Print one artifact: `analysis`, `trace-parsed`, `trace-stdout`, `trace-stderr`, or `agent-home`.
`--since <n>`	With `--stream trace-parsed`, skip the first N events.

--stream cannot be combined with output directory or overwrite. --since is accepted only with --stream trace-parsed.

evolve analysis download "$ANALYSIS_ID" --stream analysis
evolve analysis download "$ANALYSIS_ID" --stream trace-stderr

JSON output

Command	Output with `--json`
`list`	One page with `items` and `nextCursor`.
`show`	One analysis result. A failed analysis still returns exit code `0` when read successfully.
`trace` or `download --stream trace-parsed`	One event per line.
`download` to disk	One object with `path` and the number of `files`.
`download --stream analysis`	An object containing `analysis`.
`download --stream trace-stdout` or `trace-stderr`	An object containing `log`; null when no log was stored.
`download --stream agent-home`	An object containing `files`; null when no files were stored.

See exit codes for command failures.

Files and live output

Use the shared filesystem reference for analysis files, analysis logs, and analysis procs.

These filesystem and log commands require an analysis ID. They do not select an analysis from a trial ID.

Global options apply.

Start work

Inspect results

Manage resources

evolve analysis

List analyses

Show the result

Read the transcript

Download

Files and live output