CLI
Runs
Inspect, watch, and manage workflow, agent, and eval runs.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Inspect, watch, and manage workflow, agent, and eval runs.
| Command | Description |
|---|---|
eigenpal runs list|ls [options] [source] | List runs across workflows and agents, optionally scoped to one source. |
eigenpal runs get [options] <run-id> | Get one run. |
eigenpal runs compare|diff [options] <reference-run-id> <run-id> | Compare one run against another. Repeated workflow steps are matched by stable branch/iteration path. |
eigenpal runs rerun [options] <run-id> | Create a new run from a previous run’s stored input snapshot. |
eigenpal runs promote [options] <run-id> | Promote a run into a dataset example on the run’s automation. |
eigenpal runs trace [options] <run-id> | Print raw trace.jsonl for a run, or write it with —out. |
eigenpal runs watch [options] <run-id> | Watch a run until it reaches a terminal status. |
eigenpal runs cancel [options] <run-id> | Cancel a run. |
| Command | Description |
|---|---|
eigenpal runs artifacts|artifact list|ls [options] <run-id> | List available run artifacts without downloading them. |
eigenpal runs artifacts|artifact fetch [options] <run-id> | Download run artifacts by canonical artifact path. |
eigenpal runs artifacts|artifact inspect [options] [run-id] [artifact-path] | Inspect a run XLSX artifact as structured JSON (sheet names, headers, typed rows). Use —file for a local workbook. |
| Command | Description |
|---|---|
eigenpal runs reviews|rv update [options] <run-id> | Edit review verdict, status, note, or corrected JSON for a run. |
eigenpal runs reviews|rv close [options] <run-id> | Mark a run review as closed. |
eigenpal runs reviews|rv clear [options] <run-id> | Delete review metadata, corrected JSON, and corrected files for a run. |
| Command | Description |
|---|---|
eigenpal runs expected list|ls [options] <run-id> | List expected JSON and files attached to a run. |
eigenpal runs expected pull [options] <run-id> | Download expected JSON and files attached to a run. |
eigenpal runs expected upload [options] <run-id> <file> | Upload a local file as an expected artifact. |
eigenpal runs expected copy-output [options] <run-id> <output-file> | Copy a generated output file into expected artifacts. |
eigenpal runs expected rename [options] <run-id> <old-name> <new-name> | Rename an expected artifact. |
eigenpal runs expected delete [options] <run-id> <name> | Delete an expected artifact. |
eigenpal runs list|ls [options] [source]| Name | Required | Variadic | Description |
|---|---|---|---|
source | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--limit <n> | no | 50 | Page size |
--offset <n> | no | 0 | Page offset |
--json | no | Emit machine-readable JSON on stdout | |
--type <type> | no | Filter by run type: workflow|agent | |
--status <status> | no | Filter by run status | |
--source-ref <ref> | no | Filter agent runs by source ref | |
--batch-id <id> | no | Filter eval/experiment runs by batch id | |
--example-id <id> | no | Filter eval runs by example id | |
--example-id-contains <text> | no | Filter eval runs by example id substring | |
--from <date> | no | Created at or after this ISO timestamp or relative date | |
--to <date> | no | Created before this ISO timestamp or relative date | |
--created-after <date> | no | Alias for —from | |
--created-before <date> | no | Alias for —to | |
--completed-after <date> | no | Completed at or after this ISO timestamp or relative date | |
--completed-before <date> | no | Completed before this ISO timestamp or relative date | |
--compact | no | Render compact run rows | |
--sort <field> | no | Sort field; only createdAt is supported | |
--order <asc|desc> | no | Sort order; only desc is supported |
eigenpal runs get [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--step <name> | no | For workflow runs, show only this step (or comma-separated list) | |
--select <path> | no | Print only a nested JSON value; implies JSON output (for example output.subjects or output.subjects[].name) | |
--expand <sections> | no | Comma-separated server expand sections for GET /api/v1/runs/:id: input, usage, execution, debug. Use execution for status/schemaValid; completed runs include top-level output/files/error. | |
--include <parts> | no | "review" | Comma-separated local workflow step projection fields (error, duration, inputRef, …). Legacy expand names are mapped when possible; use —expand for server sections. |
eigenpal runs compare|diff [options] <reference-run-id> <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
reference-run-id | yes | no | |
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--baseline | no | Compare actual outputs from both runs instead of expected artifacts | |
--step <name-or-path> | no | For workflow runs, restrict by step name or stable path | |
--out <dir> | no | Write comparison artifacts to this directory | |
--normalize-dates | no | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text | |
--fail-on-diff | no | Exit 1 when comparison status is fail |
eigenpal runs rerun [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--version <version> | no | Version/source ref for the new run: latest (default), original, or an explicit ref (same grammar as eigenpal run) | |
--source-ref <ref> | no | Alias for —version | |
--wait | no | Poll until the rerun reaches a terminal status | |
--interval <seconds> | no | 2 | Polling interval in seconds |
--max-wait <seconds> | no | 1800 | Maximum wait before exit code 2 |
eigenpal runs promote [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--name <name> | no | Name for the created example |
eigenpal runs trace [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <file> | no | Output file path |
eigenpal runs watch [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--interval <seconds> | no | 2 | Polling interval in seconds |
--max-wait <seconds> | no | 1800 | Maximum wait before exit code 2 |
eigenpal runs cancel [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--yes | no | Skip confirmation (required in CI / agent terminals without a TTY) |
eigenpal runs artifacts|artifact list|ls [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal runs artifacts|artifact fetch [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <dir> | no | Output directory | |
--include <parts> | no | "all" | Comma-separated parts: output,input,metadata,issues,trace,lockfile,expected,all |
--path <path> | no | [] | Fetch one exact artifact path from artifacts list; repeatable |
--json | no | Output a JSON summary of written artifacts |
eigenpal runs artifacts|artifact inspect [options] [run-id] [artifact-path]| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | no | no | |
artifact-path | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--file <path> | no | Inspect a local .xlsx/.xls file instead of downloading a run artifact | |
--path <path> | no | Canonical artifact path from artifacts list (alias for positional artifact-path) | |
--sheet <names> | no | Comma-separated sheet names or zero-based indices to include | |
--max-sheets <n> | no | Maximum sheets to include (default 20) | |
--max-rows <n> | no | Maximum data rows per sheet (default 500) | |
--max-cols <n> | no | Maximum columns per sheet (default 50) |
eigenpal runs reviews|rv update [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--status <open|closed|wont_fix> | no | Set review lifecycle status | |
--verdict <correct|incorrect> | no | Set reviewer verdict | |
--note <text> | no | Set review note | |
--note-file <path> | no | Read review note from a file | |
--corrected-json <json> | no | Set corrected JSON output | |
--corrected-json-file <path> | no | Read corrected JSON output from a file | |
--clear-note | no | Clear the review note | |
--clear-corrected-json | no | Delete corrected JSON output |
eigenpal runs reviews|rv close [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--note <text> | no | Set developer close note | |
--note-file <path> | no | Read developer close note from a file |
eigenpal runs reviews|rv clear [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--yes | no | Skip typed-slug confirmation (required in CI / agent terminals without a TTY) |
eigenpal runs expected list|ls [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal runs expected pull [options] <run-id>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <dir> | no | Output directory |
eigenpal runs expected upload [options] <run-id> <file>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
file | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--name <name> | no | Expected artifact name |
eigenpal runs expected copy-output [options] <run-id> <output-file>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
output-file | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--name <name> | no | Expected artifact name |
eigenpal runs expected rename [options] <run-id> <old-name> <new-name>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
old-name | yes | no | |
new-name | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal runs expected delete [options] <run-id> <name>| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
name | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--yes | no | Skip typed-slug confirmation (required in CI / agent terminals without a TTY) |