Agents - EigenPal Docs

Commands

Core

Command	Description
`eigenpal agents list\|ls [options]`	List agents.
`eigenpal agents delete [options] <agent-id-or-slug>`	Delete an agent and its versions from the server.
`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.

File

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.

Secrets

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.

Dataset

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/.
`eigenpal agents dataset review-request list\|ls [options] <automation-id>`
`eigenpal agents dataset review-request create [options] <automation-id>`	Request human review of dataset ground truth. Snapshot examples and poll progress until review is complete.
`eigenpal agents dataset review-request get [options] <automation-id> <review-id>`	Fetch one dataset review request with items, progress, focus fields, ignored fields, expected files, file decisions, and events.
`eigenpal agents dataset review-request update [options] <automation-id> <review-id>`	Update review metadata or lifecycle status. Set —status closed when review is finished.
`eigenpal agents dataset review-request items [options] <automation-id> <review-id>`	List snapshotted review items and their statuses.
`eigenpal agents dataset review-request events [options] <automation-id> <review-id>`	List review activity, including example and field notes.
`eigenpal agents dataset review-request item [options] <automation-id> <review-id> <item-id>`	Approve, remove, reopen, comment, edit, or record a field- or file-decision on one review item. Upload corrected expected-file bytes with edit-file.
`eigenpal agents dataset review-request pull [options] <automation-id> <review-id>`	Download review snapshots: per-example expected files (snapshot or reviewer-corrected) plus item JSON.

Experiment

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.

Session

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.

Env

Command	Description
`eigenpal agents env pull [options] [target]`	Decrypt source secrets and print shell exports.

Details

`eigenpal agents list|ls [options]`

List agents.

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 delete [options] <agent-id-or-slug>`

Delete an agent and its versions from the server.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

Flag	Required	Description
`--base-url <url>`	no	Server base URL
`--json`	no	Emit machine-readable JSON on stdout
`--yes`	no	Skip typed-id confirmation (required in CI / agent terminals without a TTY)

`eigenpal agents validate [options] [dir]`

Validate a local agent package (layout, manifest, schemas, and Git source rules).

Arguments

Name	Required	Variadic	Description
`dir`	no	no

Options

Flag	Required	Default	Description
`--json`	no		Emit machine-readable JSON on stdout

`eigenpal agents clone [options]`

Clone the organization source repository.

Options

Flag	Required	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]`

Materialize a source package and its workspace dependencies.

Arguments

Name	Required	Variadic	Description
`packageRef`	no	no

Options

Flag	Required	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>`

Create a new source package scaffold.

Arguments

Name	Required	Variadic	Description
`name`	yes	no

Options

Flag	Required	Default	Description
`--template <template>`	yes		Package template
`--dir <dir>`	no		Repository directory

`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.

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--dir <dir>`	no		Repository directory

`eigenpal agents commit [options]`

Validate changed source packages and commit them.

Options

Flag	Required	Description
`--base-url <url>`	no	Server base URL
`-m, --message <message>`	yes	Commit message
`--dir <dir>`	no	Repository directory

`eigenpal agents save [options]`

Validate, commit if dirty, and push the current source branch.

Options

Flag	Required	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]`

Push the current organization source branch and tags.

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--dir <dir>`	no		Repository directory

`eigenpal agents upgrade [options]`

Upgrade the source repository schema in place.

Options

Flag	Required	Default	Description
`--dir <dir>`	no		Repository directory
`--dry-run`	no		Print upgrade actions without changing files

`eigenpal agents doctor [options]`

Check organization source repository health.

Options

Flag	Required	Default	Description
`--json`	no		Emit machine-readable JSON on stdout
`--dir <dir>`	no		Directory to inspect

`eigenpal agents status [options]`

Show source repo and package status.

Options

Flag	Required	Default	Description
`--json`	no		Emit machine-readable JSON on stdout
`--dir <dir>`	no		Directory to inspect

`eigenpal agents deps [options]`

List package workspace dependencies.

Options

Flag	Required	Default	Description
`--json`	no		Emit machine-readable JSON on stdout
`--dir <dir>`	no		Directory to inspect

`eigenpal agents clean [options]`

Require a clean source working tree.

Options

Flag	Required	Default	Description
`--dir <dir>`	no		Directory to inspect

`eigenpal agents show [options] <automation>`

Show Git-backed automation details.

Arguments

Name	Required	Variadic	Description
`automation`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout

`eigenpal agents versions [options] <package>`

List package release versions.

Arguments

Name	Required	Variadic	Description
`package`	yes	no

Options

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]`

Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead.

Arguments

Name	Required	Variadic	Description
`version`	yes	no	Version (X.Y.Z) or bump level (patch, minor, major)
`dir`	no	no	Package directory

Options

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]`

Sync an automation from the latest Git source release.

Arguments

Name	Required	Variadic	Description
`automation`	no	no

Options

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>`

List live files for an agent.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

Flag	Required	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>`

Download one live agent file.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no
`remote-path`	yes	no

Options

Flag	Required	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>`

Compare one live agent file against a local file.

Arguments

Name	Required	Variadic
`agent-id-or-slug`	yes	no
`remote-path`	yes	no
`local-path`	yes	no

Options

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]`

List secret names declared in secrets.enc.yaml (never prints values).

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>`

Encrypt and set a secret value in secrets.enc.yaml.

Arguments

Name	Required	Variadic	Description
`name`	yes	no

Options

Flag	Required	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>`

Remove a secret from secrets.enc.yaml.

Arguments

Name	Required	Variadic	Description
`name`	yes	no

Options

Flag	Required	Default	Description
`--dir <dir>`	no		Directory to inspect

`eigenpal agents secrets|secret import [options] <env-file>`

Import KEY=value entries from an env file into secrets.enc.yaml.

Arguments

Name	Required	Variadic	Description
`env-file`	yes	no

Options

Flag	Required	Default	Description
`--dir <dir>`	no		Directory to inspect

`eigenpal agents secrets|secret export [options] [target]`

Decrypt source secrets and print shell exports.

Arguments

Name	Required	Variadic	Description
`target`	no	no

Options

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>`

List dataset examples for an agent.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	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		Emit machine-readable JSON on stdout

`eigenpal agents dataset push [options] <agent-id-or-slug>`

Upload dataset examples from a local dataset directory or zip archive.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

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>`

Download an agent dataset as a .zip archive.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

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]`

Validate a local dataset directory against the canonical examples/<name> layout. Defaults to ./dataset/.

Arguments

Name	Required	Variadic	Description
`path`	no	no

Options

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 dataset review-request list|ls [options] <automation-id>`

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--status <csv>`	no		Filter by review status (comma-separated: draft,open,paused,closed,cancelled)
`--limit <n>`	no	`50`	Page size
`--offset <n>`	no	`0`	Page offset
`--json`	no		Emit machine-readable JSON on stdout

`eigenpal agents dataset review-request create [options] <automation-id>`

Request human review of dataset ground truth. Snapshot examples and poll progress until review is complete.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout
`--title <title>`	yes		Review request title
`--example-name <name>`	yes	`[]`	Example folder name to include (repeatable)
`--instructions <text>`	no		Note shown to the reviewer for the whole request
`--focus <path>`	no	`[]`	Expected-output leaf path to flag across selected examples; parent paths flag every descendant (repeatable)
`--focus-reason <spec>`	no	`[]`	Reason a focus path needs review, as path=reason (repeatable)
`--ignore <path>`	no	`[]`	Expected-output path reviewers can skip (repeatable)
`--item-note <spec>`	no	`[]`	Example-level note seeded at create time, as exampleName=comment (repeatable)
`--field-note <spec>`	no	`[]`	Field comment only, as exampleName.path=comment; does not flag the field (repeatable)
`--focus-json <json>`	no		JSON array of { path, reason? } focus fields
`--notes-json <json>`	no		JSON array of { exampleName, comment?, fields?: [{ path, comment }] }
`--status <draft\|open\|paused>`	no		Initial lifecycle status (default: draft)

`eigenpal agents dataset review-request get [options] <automation-id> <review-id>`

Fetch one dataset review request with items, progress, focus fields, ignored fields, expected files, file decisions, and events.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no
`review-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout

`eigenpal agents dataset review-request update [options] <automation-id> <review-id>`

Update review metadata or lifecycle status. Set —status closed when review is finished.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no
`review-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout
`--title <title>`	no		New review request title
`--instructions <text>`	no		Note shown to the reviewer for the whole request
`--focus <path>`	no	`[]`	Replace focus paths (repeatable; use with —focus-reason / —focus-json)
`--focus-reason <spec>`	no	`[]`	Reason a focus path needs review, as path=reason (repeatable)
`--focus-json <json>`	no		JSON array of { path, reason? } focus fields (replaces focus)
`--ignore <path>`	no		Replace ignored paths (repeatable)
`--status <draft\|open\|paused\|closed\|cancelled>`	no		Lifecycle status

`eigenpal agents dataset review-request items [options] <automation-id> <review-id>`

List snapshotted review items and their statuses.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no
`review-id`	yes	no

Options

Flag	Required	Description
`--base-url <url>`	no	Server base URL
`--json`	no	Emit machine-readable JSON on stdout
`--status <csv>`	no	Filter by item status (pending,approved,edited,removed)

`eigenpal agents dataset review-request events [options] <automation-id> <review-id>`

List review activity, including example and field notes.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no
`review-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout

`eigenpal agents dataset review-request item [options] <automation-id> <review-id> <item-id>`

Approve, remove, reopen, comment, edit, or record a field- or file-decision on one review item. Upload corrected expected-file bytes with edit-file.

Arguments

Name	Required	Variadic
`automation-id`	yes	no
`review-id`	yes	no
`item-id`	yes	no

Options

Flag	Required	Default	Description
`--base-url <url>`	no		Server base URL
`--json`	no		Emit machine-readable JSON on stdout
`--action <approve\|remove\|reopen\|comment\|edit\|field-decision\|file-decision\|edit-file>`	yes		Item action
`--expected-updated-at <iso>`	yes		Item updatedAt the client last observed (optimistic concurrency)
`--comment <text>`	no		Note stored on the item, field, or file
`--field-path <path>`	no		Dotted expected-output path for comment or field-decision
`--file-path <path>`	no		Expected-file path for file-decision or edit-file (correct)
`--new-path <path>`	no		Expected-file path for edit-file uploads of brand-new reviewer files
`--file <local path>`	no		Local file bytes to upload when —action edit-file
`--decision <approved\|removed\|null>`	no		Field or file decision for —action field-decision or file-decision (null/clear removes it)
`--clear`	no	`false`	Clear a field or file decision (sends decision: null)
`--expected-json <json>`	no		Replacement expected JSON when —action edit

`eigenpal agents dataset review-request pull [options] <automation-id> <review-id>`

Download review snapshots: per-example expected files (snapshot or reviewer-corrected) plus item JSON.

Arguments

Name	Required	Variadic	Description
`automation-id`	yes	no
`review-id`	yes	no

Options

Flag	Required	Description
`--base-url <url>`	no	Server base URL
`--json`	no	Emit machine-readable JSON on stdout
`--out <dir>`	yes	Local directory to materialize the review into

`eigenpal agents experiment|exp run [options] <agent-id-or-slug>`

Start an experiment over dataset examples.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

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>`

Get experiment status.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no
`batch-id`	yes	no

Options

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]`

Print experiment results as JSON or CSV.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no
`batch-id`	no	no

Options

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>`

List experiments.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	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		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>`

Compare evaluator scores or actual outputs between two experiment batches.

Arguments

Name	Required	Variadic	Description
`batch-id-a`	yes	no
`batch-id-b`	yes	no

Options

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>`

Cancel every active execution in an experiment.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no
`batch-id`	yes	no

Options

Flag	Required	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>`

List builder sessions for an agent.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	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		Emit machine-readable JSON on stdout

`eigenpal agents session get [options] <session-id>`

Get a builder session and messages.

Arguments

Name	Required	Variadic	Description
`session-id`	yes	no

Options

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>`

Start a builder session.

Arguments

Name	Required	Variadic	Description
`agent-id-or-slug`	yes	no

Options

Flag	Required	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>`

Append a message to a builder session.

Arguments

Name	Required	Variadic	Description
`session-id`	yes	no

Options

Flag	Required	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>`

Stop a builder session.

Arguments

Name	Required	Variadic	Description
`session-id`	yes	no

Options

Flag	Required	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]`

Decrypt source secrets and print shell exports.

Arguments

Name	Required	Variadic	Description
`target`	no	no

Options

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

​Commands

​Core

​File

​Secrets

​Dataset

​Experiment

​Session

​Env

​Details

​eigenpal agents list|ls [options]

​Options

​eigenpal agents delete [options] <agent-id-or-slug>

​Arguments

​Options

​eigenpal agents validate [options] [dir]

​Arguments

​Options

​eigenpal agents clone [options]

​Options

​eigenpal agents install [options] [packageRef]

​Arguments

​Options

​eigenpal agents init [options] <name>

​Arguments

​Options

​eigenpal agents pull [options]

​Options

​eigenpal agents commit [options]

​Options

​eigenpal agents save [options]

​Options

​eigenpal agents push [options]

​Options

​eigenpal agents upgrade [options]

​Options

​eigenpal agents doctor [options]

​Options

​eigenpal agents status [options]

​Options

​eigenpal agents deps [options]

​Options

​eigenpal agents clean [options]

​Options

​eigenpal agents show [options] <automation>

​Arguments

​Options

​eigenpal agents versions [options] <package>

​Arguments

​Options

​eigenpal agents release [options] <version> [dir]

​Arguments

​Options

​eigenpal agents sync [options] [automation]

​Arguments

​Options

​eigenpal agents file list|ls [options] <agent-id-or-slug>

​Arguments

​Options

​eigenpal agents file get [options] <agent-id-or-slug> <remote-path>

​Arguments

​Options

​eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>

​Arguments

​Options

​eigenpal agents secrets|secret list|ls [options]

​Options

​eigenpal agents secrets|secret set [options] <name>

​Arguments

​Options

​eigenpal agents secrets|secret unset [options] <name>

​Arguments

​Options

​eigenpal agents secrets|secret import [options] <env-file>

​Arguments

​Options

​eigenpal agents secrets|secret export [options] [target]

​Arguments

​Options

​eigenpal agents dataset list|ls [options] <agent-id-or-slug>

​Arguments

Commands

Core

File

Secrets

Dataset

Experiment

Session

Env

Details

`eigenpal agents list|ls [options]`

Options

`eigenpal agents delete [options] <agent-id-or-slug>`

Arguments

Options

`eigenpal agents validate [options] [dir]`

Arguments

Options

`eigenpal agents clone [options]`

Options

`eigenpal agents install [options] [packageRef]`

Arguments

Options

`eigenpal agents init [options] <name>`

Arguments

Options

`eigenpal agents pull [options]`

Options

`eigenpal agents commit [options]`

Options

`eigenpal agents save [options]`

Options

`eigenpal agents push [options]`

Options

`eigenpal agents upgrade [options]`

Options

`eigenpal agents doctor [options]`

Options

`eigenpal agents status [options]`

Options

`eigenpal agents deps [options]`

Options

`eigenpal agents clean [options]`

Options

`eigenpal agents show [options] <automation>`

Arguments

Options

`eigenpal agents versions [options] <package>`

Arguments

Options

`eigenpal agents release [options] <version> [dir]`

Arguments

Options

`eigenpal agents sync [options] [automation]`

Arguments

Options

`eigenpal agents file list|ls [options] <agent-id-or-slug>`

Arguments

Options

`eigenpal agents file get [options] <agent-id-or-slug> <remote-path>`

Arguments

Options

`eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>`

Arguments

Options

`eigenpal agents secrets|secret list|ls [options]`

Options

`eigenpal agents secrets|secret set [options] <name>`

Arguments

Options

`eigenpal agents secrets|secret unset [options] <name>`

Arguments

Options

`eigenpal agents secrets|secret import [options] <env-file>`

Arguments

Options

`eigenpal agents secrets|secret export [options] [target]`

Arguments

Options

`eigenpal agents dataset list|ls [options] <agent-id-or-slug>`

Arguments