> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolvingmachines.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# evolve analysis

> List, inspect, and download trace-analysis runs.

```bash theme={null}
evolve analysis <command> [options]
```

`show`, `trace` and `download` take an analysis id, or a trial id. An analysis id (or its unambiguous prefix) names that run. A trial id (or prefix) names the trial's latest analysis, the one `trial show` prints on its analysis row. A prefix matching both an analysis and a trial is refused as ambiguous, naming both.

A trial nobody analyzed is refused with the remedy, `evolve analyze <job>`, and so is a regrade result's id. An id you cannot read answers `analysis_not_found`; `download` on a run still queued or running answers `analysis_not_terminal`.

## analysis list

```bash theme={null}
evolve analysis list [options]
```

List analysis runs, newest first, with the trial, job and task each one judged.

<ParamField path="-l, --limit" type="n">
  Page size.
</ParamField>

<ParamField path="--cursor" type="c">
  Resume from a page cursor.
</ParamField>

<ParamField path="--columns" type="keys | all | help">
  Choose and order columns, comma-separated. `help` lists the keys.
</ParamField>

<ParamField path="-q, --quiet">
  Print only ids, one per line, for piping.
</ParamField>

<ParamField path="--no-trunc">
  Full cell content instead of one-line truncation.
</ParamField>

<ParamField path="--no-headers">
  Omit the header row in piped (TSV) output.
</ParamField>

<ParamField path="--scope" type="my | shared">
  Visibility scope: `my`, what you created (the default), or `shared`, your organizations' rows that teammates created.
</ParamField>

<ParamField path="--job" type="job-id">
  Only analyses of this job's trials. An id, or an unambiguous prefix.
</ParamField>

<ParamField path="--status" type="s1,s2,...">
  Filter by analysis status: `queued`, `running`, `completed`, `failed`.
</ParamField>

```bash theme={null}
evolve analysis list --job 3e1f9a2c-… --status failed
```

## analysis show

```bash theme={null}
evolve analysis show <analysis-id | trial-id>
```

Show one analysis run in full: the verdict document.

## analysis trace

```bash theme={null}
evolve analysis trace <analysis-id | trial-id> [options]
```

Print the analyzer's own parsed transcript.

<ParamField path="--since" type="n">
  Skip the first N events. To resume, pass the count you already hold; sequence numbers are dense from 0, so N is also the next one.
</ParamField>

## analysis download

```bash theme={null}
evolve analysis download <analysis-id | trial-id> [options]
```

Save an analysis run as a trial folder plus `evolve.json`, or stream one artifact.

<ParamField path="-o, --output-dir" type="dir" default="analyses/">
  Directory to save under. The run lands in `<dir>/analyze-<analyzed trial>__<7 chars>/`, the run's own folder name, read from the archive.
</ParamField>

<ParamField path="--overwrite">
  Replace an existing folder of the same name.
</ParamField>

<ParamField path="--stream" type="artifact">
  Print one artifact to stdout instead of saving: `analysis` (the verdict document), `trace-parsed`, `trace-stdout`, `trace-stderr` or `agent-home`.
</ParamField>

<ParamField path="--since" type="n">
  With `--stream trace-parsed`: skip the first N events.
</ParamField>

```bash theme={null}
evolve analysis download a0a1b2c3-… --stream trace-stdout
```

## Global options

<ParamField path="--json">
  Machine-readable JSON output.
</ParamField>

<ParamField path="--api-key" type="key">
  API key. Defaults to `$EVOLVE_API_KEY`.
</ParamField>

<ParamField path="--base-url" type="url">
  API base URL. Defaults to the Evolve dashboard API.
</ParamField>