Files, logs, and processes

files, logs, and procs read a run’s files, output, and live processes. The same commands work for trials, analysis runs, and individual task checks.

Resource	Command prefix	ID source
Evaluation trial	`evolve trial`	`evolve job trials "$JOB_ID"`
Analysis run	`evolve analysis`	`evolve analysis list`
Task check	`evolve check`	`evolve check show "$CHECK_ID" --json`

$JOB_ID comes from evolve job list; $CHECK_ID comes from evolve check list. Use the corresponding full resource ID as $TRIAL_ID, $ANALYSIS_ID, or $TASK_CHECK_ID below.

Choose a resource

Trial
Analysis
Task check

evolve trial files status "$TRIAL_ID"
evolve trial files list "$TRIAL_ID" /
evolve trial files cat "$TRIAL_ID" /app/result.txt

evolve analysis files status "$ANALYSIS_ID"
evolve analysis files list "$ANALYSIS_ID" /
evolve analysis files cat "$ANALYSIS_ID" /app/analysis.json

Use an analysis ID, not the evaluated trial’s ID.

evolve check files status "$TASK_CHECK_ID"
evolve check files list "$TASK_CHECK_ID" /
evolve check files cat "$TASK_CHECK_ID" /app/task/task.toml

Use the individual task-check ID, not the parent check ID.

The file paths above are examples. List the folder first and choose a path that exists in your run. For the commands below, replace trial and $TRIAL_ID with the resource prefix and ID you selected.

Live or captured?

files status reports what is available.

State	What you can inspect
`live`	Files in the running sandbox.
`capturing`	Capture is still being written.
`captured`	The stored file tree.
`none`	No live sandbox or available capture.

Reads normally choose the available source. Add --source live or --source capture to require one; an unavailable source returns an error.

A capture is not a full copy of the original image. Unchanged image files can appear in listings without stored bytes. Reading one returns not_captured. Search also excludes files whose bytes were not captured.

Browse and read

Command	Options
`files status <id>`	No command-specific options.
`files list <id> [path]`	Path defaults to `/`; `--source`; `-l, --limit` (default `500`, max `1000`); `--cursor <name>`.
`files cat <id> <path>`	`--source`; `--range <bytes=a-b>`.

files ls is an alias of files list. Listing cursors come from next_cursor; pass that value to --cursor for the next page. With --json, status returns one object and list returns one page.

Byte ranges and binary output

Range	Selects
`bytes=0-1023`	The first 1024 bytes.
`bytes=1024-`	Everything from byte 1024 onward.
`bytes=-1024`	The last 1024 bytes.

files cat writes raw bytes. Redirect them to a local file when needed.

evolve trial files cat "$TRIAL_ID" /app/result.txt > result.txt

With --json, the response contains base64 data, encoding, bytes, and path.

Search and changes

Command	Options
`files search <id> <text>`	`--path <folder>` (default `/`); `--regex`; `-l, --limit` (default `200`, max `1000`); `--source`.
`files changes <id>`	`--phase <setup\|agent\|verifier\|all>` (default `all`); `-l, --limit` (default `500`, max `1000`); `--cursor <path>`; `--source`.

Search reports file paths, line numbers, and snippets. Narrow --path when searching the whole sandbox is unnecessary. Changes report created, modified, and removed files by execution phase. Use next_cursor to read the next page. With --json, search returns hits and truncated; changes returns items, total, changed_bytes, and next_cursor.

Download a subtree

evolve trial files archive "$TRIAL_ID" --path /app -o archives/

Option	Meaning
`--path <path>`	Subtree to archive. Default `/`.
`--source <live\|capture>`	Require a specific source.
`-o`, `--output-dir <dir>`	Save the `.tar.gz` file and print its path.

Without an output directory, the command writes archive bytes to stdout. With --json, those bytes are base64; when saving to disk, JSON returns the saved path.

Logs

evolve trial logs "$TRIAL_ID" --stream agent --follow

Option	Meaning
`--stream <name>`	Required: `agent`, `verifier`, or `system`.
`-f`, `--follow`	Keep printing new lines while the sandbox lives.
`-l`, `--limit <n>`	Lines per page without follow. Default and maximum `1000`.
`--cursor <seq>`	Resume after this line sequence.

system is recorded only when the job enabled --system-log. setup and metrics are accepted stream names but are not recorded today. Without follow, JSON is a page of lines. With follow, each line is a separate JSON record. --limit does not limit a follow stream. If a followed stream is refused, the command prints the reason to stderr and exits with code 1.

Processes

procs <id> reads the running sandbox’s process list. It accepts only global options and is unavailable after the sandbox ends.

evolve trial procs "$TRIAL_ID" --json

Published task files

These commands read the task package, not a trial sandbox. Pin the dataset version.

DATASET="deepswe@1.1"
TASK="anko-default-function-arguments"
evolve dataset files status "$DATASET" "$TASK"
evolve dataset files list "$DATASET" "$TASK" /
evolve dataset files cat "$DATASET" "$TASK" /instruction.md

Command	Options
`dataset files status <name@version> <task>`	No command-specific options.
`dataset files list <name@version> <task> [path]`	Path defaults to `/`; `-l, --limit` (default `500`, max `1000`); `--cursor <name>`.
`dataset files cat <name@version> <task> <path>`	`--range <bytes=a-b>`.

Task-package reads have no live/capture selector. All commands accept global options.

Start work

Inspect results

Manage resources

Files, logs, and processes

Choose a resource

Live or captured?

Browse and read

Search and changes

Download a subtree

Logs

Processes

Published task files