CLI
Agents
Manage EigenPal agents: Git source, datasets, experiments, sessions, and releases.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Manage EigenPal agents: Git source, datasets, experiments, sessions, and releases.
| Command | Description |
|---|---|
eigenpal agents list|ls [options] | List agents. |
eigenpal agents validate [options] [dir] | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
eigenpal agents clone [options] | Clone the organization source repository. |
eigenpal agents install [options] [packageRef] | Materialize a source package and its workspace dependencies. |
eigenpal agents init [options] <name> | Create a new source package scaffold. |
eigenpal agents pull [options] | Pull organization source from origin/main with —ff-only. For datasets use agents dataset pull; for run artifacts use runs artifacts fetch. |
eigenpal agents commit [options] | Validate changed source packages and commit them. |
eigenpal agents save [options] | Validate, commit if dirty, and push the current source branch. |
eigenpal agents push [options] | Push the current organization source branch and tags. |
eigenpal agents upgrade [options] | Upgrade the source repository schema in place. |
eigenpal agents doctor [options] | Check organization source repository health. |
eigenpal agents status [options] | Show source repo and package status. |
eigenpal agents deps [options] | List package workspace dependencies. |
eigenpal agents clean [options] | Require a clean source working tree. |
eigenpal agents show [options] <automation> | Show Git-backed automation details. |
eigenpal agents versions [options] <package> | List package release versions. |
eigenpal agents release [options] <version> [dir] | Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead. |
eigenpal agents sync [options] [automation] | Sync an automation from the latest Git source release. |
| Command | Description |
|---|---|
eigenpal agents file list|ls [options] <agent-id-or-slug> | List live files for an agent. |
eigenpal agents file get [options] <agent-id-or-slug> <remote-path> | Download one live agent file. |
eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path> | Compare one live agent file against a local file. |
| Command | Description |
|---|---|
eigenpal agents secrets|secret list|ls [options] | List secret names declared in secrets.enc.yaml (never prints values). |
eigenpal agents secrets|secret set [options] <name> | Encrypt and set a secret value in secrets.enc.yaml. |
eigenpal agents secrets|secret unset [options] <name> | Remove a secret from secrets.enc.yaml. |
eigenpal agents secrets|secret import [options] <env-file> | Import KEY=value entries from an env file into secrets.enc.yaml. |
eigenpal agents secrets|secret export [options] [target] | Decrypt source secrets and print shell exports. |
| Command | Description |
|---|---|
eigenpal agents dataset list|ls [options] <agent-id-or-slug> | List dataset examples for an agent. |
eigenpal agents dataset push [options] <agent-id-or-slug> | Upload dataset examples from a local dataset directory or zip archive. |
eigenpal agents dataset pull [options] <agent-id-or-slug> | Download an agent dataset as a .zip archive. |
eigenpal agents dataset validate [options] [path] | Validate a local dataset directory against the canonical examples/<name> layout. Defaults to ./dataset/. |
| Command | Description |
|---|---|
eigenpal agents experiment|exp run [options] <agent-id-or-slug> | Start an experiment over dataset examples. |
eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id> | Get experiment status. |
eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id] | Print experiment results as JSON or CSV. |
eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug> | List experiments. |
eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b> | Compare evaluator scores or actual outputs between two experiment batches. |
eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id> | Cancel every active execution in an experiment. |
| Command | Description |
|---|---|
eigenpal agents session list|ls [options] <agent-id-or-slug> | List builder sessions for an agent. |
eigenpal agents session get [options] <session-id> | Get a builder session and messages. |
eigenpal agents session start [options] <agent-id-or-slug> | Start a builder session. |
eigenpal agents session message [options] <session-id> | Append a message to a builder session. |
eigenpal agents session stop [options] <session-id> | Stop a builder session. |
| Command | Description |
|---|---|
eigenpal agents env pull [options] [target] | Decrypt source secrets and print shell exports. |
eigenpal agents list|ls [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 | Emit machine-readable JSON on stdout | |
--search <q> | no | Search by slug, name, or description |
eigenpal agents validate [options] [dir]| Name | Required | Variadic | Description |
|---|---|---|---|
dir | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout |
eigenpal agents clone [options]| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <dir> | no | Output directory | |
--tenant-id <tenantId> | no | Target tenant id for admin-token source clones |
eigenpal agents install [options] [packageRef]| Name | Required | Variadic | Description |
|---|---|---|---|
packageRef | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <dir> | no | Output directory for an explicit package ref | |
--lockfile <path> | no | Lockfile path | |
--frozen-lockfile | no | Install exactly from the existing lockfile | |
--remote-url <url> | no | Use an explicit organization Git remote URL |
eigenpal agents init [options] <name>| Name | Required | Variadic | Description |
|---|---|---|---|
name | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--template <template> | yes | Package template | |
--dir <dir> | no | Repository directory |
eigenpal agents pull [options]| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--dir <dir> | no | Repository directory |
eigenpal agents commit [options]| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
-m, --message <message> | yes | Commit message | |
--dir <dir> | no | Repository directory |
eigenpal agents save [options]| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
-m, --message <message> | no | Commit message when source changes are dirty | |
--dir <dir> | no | Repository directory |
eigenpal agents push [options]| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--dir <dir> | no | Repository directory |
eigenpal agents upgrade [options]| Flag | Required | Default | Description |
|---|---|---|---|
--dir <dir> | no | Repository directory | |
--dry-run | no | Print upgrade actions without changing files |
eigenpal agents doctor [options]| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout | |
--dir <dir> | no | Directory to inspect |
eigenpal agents status [options]| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout | |
--dir <dir> | no | Directory to inspect |
eigenpal agents deps [options]| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout | |
--dir <dir> | no | Directory to inspect |
eigenpal agents clean [options]| Flag | Required | Default | Description |
|---|---|---|---|
--dir <dir> | no | Directory to inspect |
eigenpal agents show [options] <automation>| Name | Required | Variadic | Description |
|---|---|---|---|
automation | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal agents versions [options] <package>| Name | Required | Variadic | Description |
|---|---|---|---|
package | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal agents release [options] <version> [dir]| Name | Required | Variadic | Description |
|---|---|---|---|
version | yes | no | Version (X.Y.Z) or bump level (patch, minor, major) |
dir | no | no | Package directory |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
-m, --message <message> | no | Annotated tag message (default: Release <packagePath>) |
eigenpal agents sync [options] [automation]| Name | Required | Variadic | Description |
|---|---|---|---|
automation | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--dir <dir> | no | Directory to inspect |
eigenpal agents file list|ls [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--path <prefix> | no | Only list files beneath this relative path |
eigenpal agents file get [options] <agent-id-or-slug> <remote-path>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no | |
remote-path | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--out <file> | no | Output file path |
eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no | |
remote-path | yes | no | |
local-path | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal agents secrets|secret list|ls [options]| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout | |
--dir <dir> | no | Directory to inspect |
eigenpal agents secrets|secret set [options] <name>| Name | Required | Variadic | Description |
|---|---|---|---|
name | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--dir <dir> | no | Directory to inspect | |
--stdin | no | Read the secret value from stdin (required in CI / agent terminals) | |
--value-file <path> | no | Read the secret value from a file | |
--description <text> | no | Secret description |
eigenpal agents secrets|secret unset [options] <name>| Name | Required | Variadic | Description |
|---|---|---|---|
name | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--dir <dir> | no | Directory to inspect |
eigenpal agents secrets|secret import [options] <env-file>| Name | Required | Variadic | Description |
|---|---|---|---|
env-file | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--dir <dir> | no | Directory to inspect |
eigenpal agents secrets|secret export [options] [target]| Name | Required | Variadic | Description |
|---|---|---|---|
target | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--dir <dir> | no | "." | Installed agent package directory |
--format <format> | no | "shell" | Output format: shell or dotenv |
eigenpal agents dataset list|ls [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | 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 |
eigenpal agents dataset push [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--file <path> | yes | Dataset directory or .zip archive | |
--mode <append|replace> | no | "append" | Upload mode |
--yes | no | Skip typed-slug confirmation for —mode replace (required in CI / agent terminals) |
eigenpal agents dataset pull [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--out <path> | no | "dataset" | Output .zip path (default: dataset.zip) |
eigenpal agents dataset validate [options] [path]| Name | Required | Variadic | Description |
|---|---|---|---|
path | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--json | no | Emit machine-readable JSON on stdout | |
--agent-dir <dir> | no | "." | Agent package directory with optional input/output schemas for extra value-level checks |
eigenpal agents experiment|exp run [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--example-id <id> | no | Run one dataset example | |
--wait | no | Poll until the experiment reaches a terminal status | |
--interval <seconds> | no | 2 | Polling interval in seconds |
--max-wait <seconds> | no | 1800 | Maximum wait before exit code 2 |
eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no | |
batch-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--watch | no | Poll until complete | |
--interval <seconds> | no | 2 | Polling interval in seconds |
--max-wait <seconds> | no | 1800 | Maximum wait before exit code 2 |
eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id]| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no | |
batch-id | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--format <csv|json> | no | "json" | Output format (default json) |
--out <path> | no | Write output to file | |
--summary | no | Show total/pass/fail/error counts, average score, and evaluator rollups | |
--failed-only | no | Keep only failed or errored evaluator results | |
--evaluator <name> | no | Keep only results from this evaluator | |
--select <path> | no | Print only a nested JSON value (for example summary.byEvaluator or discrepancies[].path) |
eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | 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 | |
--batch-id <id> | no | Filter to one batch id |
eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>| Name | Required | Variadic | Description |
|---|---|---|---|
batch-id-a | yes | no | |
batch-id-b | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--outputs | no | Compare actual run outputs instead of evaluator scores | |
--sort <abs-delta-desc|delta-asc|delta-desc|name> | no | "abs-delta-desc" | Row sort order (default: biggest movers first) |
--regression-threshold <n> | no | 0.05 | Δ below this is flagged as a regression (default 0.05) |
eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no | |
batch-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 agents session list|ls [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | 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 |
eigenpal agents session get [options] <session-id>| Name | Required | Variadic | Description |
|---|---|---|---|
session-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout |
eigenpal agents session start [options] <agent-id-or-slug>| Name | Required | Variadic | Description |
|---|---|---|---|
agent-id-or-slug | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--title <title> | no | Session title |
eigenpal agents session message [options] <session-id>| Name | Required | Variadic | Description |
|---|---|---|---|
session-id | yes | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--json | no | Emit machine-readable JSON on stdout | |
--text <message> | yes | Message text |
eigenpal agents session stop [options] <session-id>| Name | Required | Variadic | Description |
|---|---|---|---|
session-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 agents env pull [options] [target]| Name | Required | Variadic | Description |
|---|---|---|---|
target | no | no |
| Flag | Required | Default | Description |
|---|---|---|---|
--base-url <url> | no | Server base URL | |
--dir <dir> | no | "." | Installed agent package directory |
--format <format> | no | "shell" | Output format: shell or dotenv |