Commands
Core
| 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 run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks. |
eigenpal runs rerun [options] <run-id> | Create a new run from a previous run’s stored input snapshot. |
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. |
Artifacts
| Command | Description |
|---|---|
eigenpal runs artifacts|artifact list|ls [options] <run-id> | List available agent run artifacts without downloading them. |
eigenpal runs artifacts|artifact fetch [options] <run-id> | Download agent run artifacts by canonical artifact path. |
Feedback
| Command | Description |
|---|---|
eigenpal runs feedback|fb update [options] <run-id> | Edit feedback state, rating, message, or expected JSON for a run. |
eigenpal runs feedback|fb resolve [options] <run-id> | Mark run feedback as resolved. |
eigenpal runs feedback|fb clear [options] <run-id> | Delete feedback, expected.json, and expected files for a run. |
Expected
| 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. |
Details
eigenpal runs list|ls [options] [source]
List runs across workflows and agents, optionally scoped to one source.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
source | no | no |
Options
| 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 | Output the raw server response as JSON | |
--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>
Get one run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--step <name> | no | For workflow runs, show only this step (or comma-separated list) | |
--include <parts> | no | "feedback" | Comma-separated extra parts or workflow step fields: feedback,expected,files,trace,issues,input,output,error,duration,inputRef |
eigenpal runs compare|diff [options] <reference-run-id> <run-id>
Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
reference-run-id | yes | no | |
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--baseline | no | Compare actual outputs from both runs instead of expected artifacts | |
--step <name> | no | For workflow runs, restrict comparison to one step | |
--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>
Create a new run from a previous run’s stored input snapshot.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--source-ref <ref> | no | Source ref for the new run: latest (default) or original. Workflow runs support only latest/original. | |
--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 exiting 2 |
eigenpal runs trace [options] <run-id>
Print raw trace.jsonl for a run, or write it with —out.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <file> | no | Output file path |
eigenpal runs watch [options] <run-id>
Watch a run until it reaches a terminal status.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--interval <seconds> | no | 2 | Polling interval in seconds |
--max-wait <seconds> | no | 1800 | Maximum wait before exiting 2 |
eigenpal runs cancel [options] <run-id>
Cancel a run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--yes | no | Required in non-interactive environments |
eigenpal runs artifacts|artifact list|ls [options] <run-id>
List available agent run artifacts without downloading them.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON |
eigenpal runs artifacts|artifact fetch [options] <run-id>
Download agent run artifacts by canonical artifact path.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| 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 feedback|fb update [options] <run-id>
Edit feedback state, rating, message, or expected JSON for a run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--status <open|resolved|ignored> | no | Set feedback status | |
--rating <pass|fail|partial|none> | no | Set feedback rating | |
--message <text> | no | Set feedback message body | |
--message-file <path> | no | Read feedback message body from a file | |
--expected-json <json> | no | Set structured expected JSON | |
--expected-json-file <path> | no | Read structured expected JSON from a file | |
--clear-message | no | Clear the feedback message body | |
--clear-rating | no | Clear feedback rating | |
--clear-expected-json | no | Delete structured expected JSON |
eigenpal runs feedback|fb resolve [options] <run-id>
Mark run feedback as resolved.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--message <text> | no | Set feedback message body | |
--message-file <path> | no | Read feedback message body from a file |
eigenpal runs feedback|fb clear [options] <run-id>
Delete feedback, expected.json, and expected files for a run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--yes | no | Required in non-interactive environments |
eigenpal runs expected list|ls [options] <run-id>
List expected JSON and files attached to a run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON |
eigenpal runs expected pull [options] <run-id>
Download expected JSON and files attached to a run.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <dir> | no | Output directory |
eigenpal runs expected upload [options] <run-id> <file>
Upload a local file as an expected artifact.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
file | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--name <name> | no | Expected artifact name |
eigenpal runs expected copy-output [options] <run-id> <output-file>
Copy a generated output file into expected artifacts.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
output-file | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--name <name> | no | Expected artifact name |
eigenpal runs expected rename [options] <run-id> <old-name> <new-name>
Rename an expected artifact.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
old-name | yes | no | |
new-name | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON |
eigenpal runs expected delete [options] <run-id> <name>
Delete an expected artifact.
Arguments
| Name | Required | Variadic | Description |
|---|---|---|---|
run-id | yes | no | |
name | yes | no |
Options
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Output the raw server response as JSON | |
--yes | no | Required in non-interactive environments |