@eigenpal/cli 0.6.9 → 0.6.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,79 +10,59 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
10
10
  - [File](#file)
11
11
  - [Secret](#secret)
12
12
  - [Dataset](#dataset)
13
- - [Runs](#runs)
14
13
  - [Experiment](#experiment)
15
14
  - [Session](#session)
16
15
  - [Env](#env)
17
16
  - [Secrets](#secrets)
18
17
  - [Details](#details)
19
- - [`eigenpal agents|agent run [options] <target>`](#eigenpal-agentsagent-run-options-target)
20
- - [`eigenpal agents|agent rerun [options] <run-id>`](#eigenpal-agentsagent-rerun-options-run-id)
21
- - [`eigenpal agents|agent list|ls [options]`](#eigenpal-agentsagent-listls-options)
22
- - [`eigenpal agents|agent validate [options] [dir]`](#eigenpal-agentsagent-validate-options-dir)
23
- - [`eigenpal agents|agent clone [options]`](#eigenpal-agentsagent-clone-options)
24
- - [`eigenpal agents|agent install [options] [packageRef]`](#eigenpal-agentsagent-install-options-packageref)
25
- - [`eigenpal agents|agent init [options] <name>`](#eigenpal-agentsagent-init-options-name)
26
- - [`eigenpal agents|agent pull [options]`](#eigenpal-agentsagent-pull-options)
27
- - [`eigenpal agents|agent commit [options]`](#eigenpal-agentsagent-commit-options)
28
- - [`eigenpal agents|agent save [options]`](#eigenpal-agentsagent-save-options)
29
- - [`eigenpal agents|agent push [options]`](#eigenpal-agentsagent-push-options)
30
- - [`eigenpal agents|agent upgrade [options]`](#eigenpal-agentsagent-upgrade-options)
31
- - [`eigenpal agents|agent doctor [options]`](#eigenpal-agentsagent-doctor-options)
32
- - [`eigenpal agents|agent status [options]`](#eigenpal-agentsagent-status-options)
33
- - [`eigenpal agents|agent deps [options]`](#eigenpal-agentsagent-deps-options)
34
- - [`eigenpal agents|agent clean [options]`](#eigenpal-agentsagent-clean-options)
35
- - [`eigenpal agents|agent show [options] <automation>`](#eigenpal-agentsagent-show-options-automation)
36
- - [`eigenpal agents|agent versions [options] <package>`](#eigenpal-agentsagent-versions-options-package)
37
- - [`eigenpal agents|agent release [options] <version> [dir]`](#eigenpal-agentsagent-release-options-version-dir)
38
- - [`eigenpal agents|agent sync [options] [automation]`](#eigenpal-agentsagent-sync-options-automation)
39
- - [`eigenpal agents|agent file list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-file-listls-options-agent-id-or-slug)
40
- - [`eigenpal agents|agent file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agentsagent-file-get-options-agent-id-or-slug-remote-path)
41
- - [`eigenpal agents|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agentsagent-file-diff-options-agent-id-or-slug-remote-path-local-path)
42
- - [`eigenpal agents|agent secret set [options] <name>`](#eigenpal-agentsagent-secret-set-options-name)
43
- - [`eigenpal agents|agent secret unset [options] <name>`](#eigenpal-agentsagent-secret-unset-options-name)
44
- - [`eigenpal agents|agent secret import [options] <env-file>`](#eigenpal-agentsagent-secret-import-options-env-file)
45
- - [`eigenpal agents|agent dataset list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-dataset-listls-options-agent-id-or-slug)
46
- - [`eigenpal agents|agent dataset push [options] <agent-id-or-slug>`](#eigenpal-agentsagent-dataset-push-options-agent-id-or-slug)
47
- - [`eigenpal agents|agent dataset pull [options] <agent-id-or-slug>`](#eigenpal-agentsagent-dataset-pull-options-agent-id-or-slug)
48
- - [`eigenpal agents|agent dataset validate [options] [path]`](#eigenpal-agentsagent-dataset-validate-options-path)
49
- - [`eigenpal agents|agent runs list|ls [options] <target>`](#eigenpal-agentsagent-runs-listls-options-target)
50
- - [`eigenpal agents|agent runs get [options] <run-id>`](#eigenpal-agentsagent-runs-get-options-run-id)
51
- - [`eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`](#eigenpal-agentsagent-runs-comparediff-options-reference-run-id-run-id)
52
- - [`eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`](#eigenpal-agentsagent-runs-artifactsartifact-listls-options-run-id)
53
- - [`eigenpal agents|agent runs artifacts|artifact fetch [options] <run-id>`](#eigenpal-agentsagent-runs-artifactsartifact-fetch-options-run-id)
54
- - [`eigenpal agents|agent runs trace [options] <run-id>`](#eigenpal-agentsagent-runs-trace-options-run-id)
55
- - [`eigenpal agents|agent runs feedback|fb update [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-update-options-run-id)
56
- - [`eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-resolve-options-run-id)
57
- - [`eigenpal agents|agent runs feedback|fb clear [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-clear-options-run-id)
58
- - [`eigenpal agents|agent runs expected list|ls [options] <run-id>`](#eigenpal-agentsagent-runs-expected-listls-options-run-id)
59
- - [`eigenpal agents|agent runs expected pull [options] <run-id>`](#eigenpal-agentsagent-runs-expected-pull-options-run-id)
60
- - [`eigenpal agents|agent runs expected upload [options] <run-id> <file>`](#eigenpal-agentsagent-runs-expected-upload-options-run-id-file)
61
- - [`eigenpal agents|agent runs expected copy-output [options] <run-id> <output-file>`](#eigenpal-agentsagent-runs-expected-copy-output-options-run-id-output-file)
62
- - [`eigenpal agents|agent runs expected rename [options] <run-id> <old-name> <new-name>`](#eigenpal-agentsagent-runs-expected-rename-options-run-id-old-name-new-name)
63
- - [`eigenpal agents|agent runs expected delete [options] <run-id> <name>`](#eigenpal-agentsagent-runs-expected-delete-options-run-id-name)
64
- - [`eigenpal agents|agent runs watch [options] <run-id>`](#eigenpal-agentsagent-runs-watch-options-run-id)
65
- - [`eigenpal agents|agent runs cancel [options] <run-id>`](#eigenpal-agentsagent-runs-cancel-options-run-id)
66
- - [`eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-run-options-agent-id-or-slug)
67
- - [`eigenpal agents|agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-status-options-agent-id-or-slug-batch-id)
68
- - [`eigenpal agents|agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agentsagent-experimentexp-results-options-agent-id-or-slug-batch-id)
69
- - [`eigenpal agents|agent experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-listls-options-agent-id-or-slug)
70
- - [`eigenpal agents|agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`](#eigenpal-agentsagent-experimentexp-comparediff-options-batch-id-a-batch-id-b)
71
- - [`eigenpal agents|agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-cancel-options-agent-id-or-slug-batch-id)
72
- - [`eigenpal agents|agent session list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-listls-options-agent-id-or-slug)
73
- - [`eigenpal agents|agent session get [options] <session-id>`](#eigenpal-agentsagent-session-get-options-session-id)
74
- - [`eigenpal agents|agent session start [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-start-options-agent-id-or-slug)
75
- - [`eigenpal agents|agent session message [options] <session-id>`](#eigenpal-agentsagent-session-message-options-session-id)
76
- - [`eigenpal agents|agent session stop [options] <session-id>`](#eigenpal-agentsagent-session-stop-options-session-id)
77
- - [`eigenpal agents|agent env pull [options] [target]`](#eigenpal-agentsagent-env-pull-options-target)
78
- - [`eigenpal agents|agent secrets export [options] [target]`](#eigenpal-agentsagent-secrets-export-options-target)
18
+ - [`eigenpal agents run [options] <target>`](#eigenpal-agents-run-options-target)
19
+ - [`eigenpal agents list|ls [options]`](#eigenpal-agents-listls-options)
20
+ - [`eigenpal agents validate [options] [dir]`](#eigenpal-agents-validate-options-dir)
21
+ - [`eigenpal agents clone [options]`](#eigenpal-agents-clone-options)
22
+ - [`eigenpal agents install [options] [packageRef]`](#eigenpal-agents-install-options-packageref)
23
+ - [`eigenpal agents init [options] <name>`](#eigenpal-agents-init-options-name)
24
+ - [`eigenpal agents pull [options]`](#eigenpal-agents-pull-options)
25
+ - [`eigenpal agents commit [options]`](#eigenpal-agents-commit-options)
26
+ - [`eigenpal agents save [options]`](#eigenpal-agents-save-options)
27
+ - [`eigenpal agents push [options]`](#eigenpal-agents-push-options)
28
+ - [`eigenpal agents upgrade [options]`](#eigenpal-agents-upgrade-options)
29
+ - [`eigenpal agents doctor [options]`](#eigenpal-agents-doctor-options)
30
+ - [`eigenpal agents status [options]`](#eigenpal-agents-status-options)
31
+ - [`eigenpal agents deps [options]`](#eigenpal-agents-deps-options)
32
+ - [`eigenpal agents clean [options]`](#eigenpal-agents-clean-options)
33
+ - [`eigenpal agents show [options] <automation>`](#eigenpal-agents-show-options-automation)
34
+ - [`eigenpal agents versions [options] <package>`](#eigenpal-agents-versions-options-package)
35
+ - [`eigenpal agents release [options] <version> [dir]`](#eigenpal-agents-release-options-version-dir)
36
+ - [`eigenpal agents sync [options] [automation]`](#eigenpal-agents-sync-options-automation)
37
+ - [`eigenpal agents file list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-file-listls-options-agent-id-or-slug)
38
+ - [`eigenpal agents file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agents-file-get-options-agent-id-or-slug-remote-path)
39
+ - [`eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agents-file-diff-options-agent-id-or-slug-remote-path-local-path)
40
+ - [`eigenpal agents secret set [options] <name>`](#eigenpal-agents-secret-set-options-name)
41
+ - [`eigenpal agents secret unset [options] <name>`](#eigenpal-agents-secret-unset-options-name)
42
+ - [`eigenpal agents secret import [options] <env-file>`](#eigenpal-agents-secret-import-options-env-file)
43
+ - [`eigenpal agents dataset list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-listls-options-agent-id-or-slug)
44
+ - [`eigenpal agents dataset push [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-push-options-agent-id-or-slug)
45
+ - [`eigenpal agents dataset pull [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-pull-options-agent-id-or-slug)
46
+ - [`eigenpal agents dataset validate [options] [path]`](#eigenpal-agents-dataset-validate-options-path)
47
+ - [`eigenpal agents experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agents-experimentexp-run-options-agent-id-or-slug)
48
+ - [`eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agents-experimentexp-status-options-agent-id-or-slug-batch-id)
49
+ - [`eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agents-experimentexp-results-options-agent-id-or-slug-batch-id)
50
+ - [`eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-experimentexp-listls-options-agent-id-or-slug)
51
+ - [`eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`](#eigenpal-agents-experimentexp-comparediff-options-batch-id-a-batch-id-b)
52
+ - [`eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agents-experimentexp-cancel-options-agent-id-or-slug-batch-id)
53
+ - [`eigenpal agents session list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-session-listls-options-agent-id-or-slug)
54
+ - [`eigenpal agents session get [options] <session-id>`](#eigenpal-agents-session-get-options-session-id)
55
+ - [`eigenpal agents session start [options] <agent-id-or-slug>`](#eigenpal-agents-session-start-options-agent-id-or-slug)
56
+ - [`eigenpal agents session message [options] <session-id>`](#eigenpal-agents-session-message-options-session-id)
57
+ - [`eigenpal agents session stop [options] <session-id>`](#eigenpal-agents-session-stop-options-session-id)
58
+ - [`eigenpal agents env pull [options] [target]`](#eigenpal-agents-env-pull-options-target)
59
+ - [`eigenpal agents secrets export [options] [target]`](#eigenpal-agents-secrets-export-options-target)
79
60
 
80
61
  ## Surface
81
62
 
82
63
  ```
83
64
  agents
84
65
  ├── run <target>
85
- ├── rerun <run-id>
86
66
  ├── list|ls
87
67
  ├── file
88
68
  │ ├── list|ls <agent-id-or-slug>
@@ -114,27 +94,6 @@ agents
114
94
  │ ├── push <agent-id-or-slug>
115
95
  │ ├── pull <agent-id-or-slug>
116
96
  │ └── validate [path]
117
- ├── runs
118
- │ ├── list|ls <target>
119
- │ ├── get <run-id>
120
- │ ├── compare|diff <reference-run-id> <run-id>
121
- │ ├── artifacts|artifact
122
- │ │ ├── list|ls <run-id>
123
- │ │ └── fetch <run-id>
124
- │ ├── trace <run-id>
125
- │ ├── feedback|fb
126
- │ │ ├── update <run-id>
127
- │ │ ├── resolve <run-id>
128
- │ │ └── clear <run-id>
129
- │ ├── expected
130
- │ │ ├── list|ls <run-id>
131
- │ │ ├── pull <run-id>
132
- │ │ ├── upload <run-id> <file>
133
- │ │ ├── copy-output <run-id> <output-file>
134
- │ │ ├── rename <run-id> <old-name> <new-name>
135
- │ │ └── delete <run-id> <name>
136
- │ ├── watch <run-id>
137
- │ └── cancel <run-id>
138
97
  ├── experiment|exp
139
98
  │ ├── run <agent-id-or-slug>
140
99
  │ ├── status <agent-id-or-slug> <batch-id>
@@ -158,112 +117,89 @@ agents
158
117
 
159
118
  ### Core
160
119
 
161
- | Command | Description |
162
- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
163
- | `eigenpal agents\|agent run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
164
- | `eigenpal agents\|agent rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
165
- | `eigenpal agents\|agent list\|ls [options]` | List agents. |
166
- | `eigenpal agents\|agent validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
167
- | `eigenpal agents\|agent clone [options]` | Clone the organization source repository. |
168
- | `eigenpal agents\|agent install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
169
- | `eigenpal agents\|agent init [options] <name>` | Create a new source package scaffold. |
170
- | `eigenpal agents\|agent pull [options]` | Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs artifacts fetch. |
171
- | `eigenpal agents\|agent commit [options]` | Validate changed source packages and commit them. |
172
- | `eigenpal agents\|agent save [options]` | Validate, commit if dirty, and push the current source branch. |
173
- | `eigenpal agents\|agent push [options]` | Push the current organization source branch and tags. |
174
- | `eigenpal agents\|agent upgrade [options]` | Upgrade the source repository schema in place. |
175
- | `eigenpal agents\|agent doctor [options]` | Check organization source repository health. |
176
- | `eigenpal agents\|agent status [options]` | Show source repo and package status. |
177
- | `eigenpal agents\|agent deps [options]` | List package workspace dependencies. |
178
- | `eigenpal agents\|agent clean [options]` | Require a clean source working tree. |
179
- | `eigenpal agents\|agent show [options] <automation>` | Show Git-backed automation details. |
180
- | `eigenpal agents\|agent versions [options] <package>` | List package release versions. |
181
- | `eigenpal agents\|agent release [options] <version> [dir]` | Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead. |
182
- | `eigenpal agents\|agent sync [options] [automation]` | Sync an automation from the latest Git source release. |
120
+ | Command | Description |
121
+ | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
122
+ | `eigenpal agents run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
123
+ | `eigenpal agents list\|ls [options]` | List agents. |
124
+ | `eigenpal agents validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
125
+ | `eigenpal agents clone [options]` | Clone the organization source repository. |
126
+ | `eigenpal agents install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
127
+ | `eigenpal agents init [options] <name>` | Create a new source package scaffold. |
128
+ | `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. |
129
+ | `eigenpal agents commit [options]` | Validate changed source packages and commit them. |
130
+ | `eigenpal agents save [options]` | Validate, commit if dirty, and push the current source branch. |
131
+ | `eigenpal agents push [options]` | Push the current organization source branch and tags. |
132
+ | `eigenpal agents upgrade [options]` | Upgrade the source repository schema in place. |
133
+ | `eigenpal agents doctor [options]` | Check organization source repository health. |
134
+ | `eigenpal agents status [options]` | Show source repo and package status. |
135
+ | `eigenpal agents deps [options]` | List package workspace dependencies. |
136
+ | `eigenpal agents clean [options]` | Require a clean source working tree. |
137
+ | `eigenpal agents show [options] <automation>` | Show Git-backed automation details. |
138
+ | `eigenpal agents versions [options] <package>` | List package release versions. |
139
+ | `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. |
140
+ | `eigenpal agents sync [options] [automation]` | Sync an automation from the latest Git source release. |
183
141
 
184
142
  ### File
185
143
 
186
- | Command | Description |
187
- | ------------------------------------------------------------------------------------------ | ------------------------------------------------- |
188
- | `eigenpal agents\|agent file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
189
- | `eigenpal agents\|agent file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
190
- | `eigenpal agents\|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
144
+ | Command | Description |
145
+ | ----------------------------------------------------------------------------------- | ------------------------------------------------- |
146
+ | `eigenpal agents file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
147
+ | `eigenpal agents file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
148
+ | `eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
191
149
 
192
150
  ### Secret
193
151
 
194
- | Command | Description |
195
- | ----------------------------------------------------------- | ---------------------------------------------------------------- |
196
- | `eigenpal agents\|agent secret set [options] <name>` | Encrypt and set a secret value in secrets.enc.yaml. |
197
- | `eigenpal agents\|agent secret unset [options] <name>` | Remove a secret from secrets.enc.yaml. |
198
- | `eigenpal agents\|agent secret import [options] <env-file>` | Import KEY=value entries from an env file into secrets.enc.yaml. |
152
+ | Command | Description |
153
+ | ---------------------------------------------------- | ---------------------------------------------------------------- |
154
+ | `eigenpal agents secret set [options] <name>` | Encrypt and set a secret value in secrets.enc.yaml. |
155
+ | `eigenpal agents secret unset [options] <name>` | Remove a secret from secrets.enc.yaml. |
156
+ | `eigenpal agents secret import [options] <env-file>` | Import KEY=value entries from an env file into secrets.enc.yaml. |
199
157
 
200
158
  ### Dataset
201
159
 
202
- | Command | Description |
203
- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------- |
204
- | `eigenpal agents\|agent dataset list\|ls [options] <agent-id-or-slug>` | List dataset examples for an agent. |
205
- | `eigenpal agents\|agent dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
206
- | `eigenpal agents\|agent dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
207
- | `eigenpal agents\|agent dataset validate [options] [path]` | Validate a local dataset directory against the agent input/output schemas. |
208
-
209
- ### Runs
210
-
211
- | Command | Description |
212
- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
213
- | `eigenpal agents\|agent runs list\|ls [options] <target>` | List runs for an agent target; unqualified targets include all source refs. |
214
- | `eigenpal agents\|agent runs get [options] <run-id>` | Get one agent run. |
215
- | `eigenpal agents\|agent 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. |
216
- | `eigenpal agents\|agent runs artifacts\|artifact list\|ls [options] <run-id>` | List available run artifacts without downloading them. |
217
- | `eigenpal agents\|agent runs artifacts\|artifact fetch [options] <run-id>` | Download run artifacts by canonical artifact path. |
218
- | `eigenpal agents\|agent runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
219
- | `eigenpal agents\|agent runs feedback\|fb update [options] <run-id>` | Edit feedback state, rating, message, or expected JSON for a run. |
220
- | `eigenpal agents\|agent runs feedback\|fb resolve [options] <run-id>` | Mark run feedback as resolved. |
221
- | `eigenpal agents\|agent runs feedback\|fb clear [options] <run-id>` | Delete feedback, expected.json, and expected files for a run. |
222
- | `eigenpal agents\|agent runs expected list\|ls [options] <run-id>` | List expected JSON and files attached to a run. |
223
- | `eigenpal agents\|agent runs expected pull [options] <run-id>` | Download expected JSON and files attached to a run. |
224
- | `eigenpal agents\|agent runs expected upload [options] <run-id> <file>` | Upload a local file as an expected artifact. |
225
- | `eigenpal agents\|agent runs expected copy-output [options] <run-id> <output-file>` | Copy a generated output file into expected artifacts. |
226
- | `eigenpal agents\|agent runs expected rename [options] <run-id> <old-name> <new-name>` | Rename an expected artifact. |
227
- | `eigenpal agents\|agent runs expected delete [options] <run-id> <name>` | Delete an expected artifact. |
228
- | `eigenpal agents\|agent runs watch [options] <run-id>` | Watch a run until it reaches a terminal status. |
229
- | `eigenpal agents\|agent runs cancel [options] <run-id>` | Cancel an agent run. |
160
+ | Command | Description |
161
+ | --------------------------------------------------------------- | -------------------------------------------------------------------------- |
162
+ | `eigenpal agents dataset list\|ls [options] <agent-id-or-slug>` | List dataset examples for an agent. |
163
+ | `eigenpal agents dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
164
+ | `eigenpal agents dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
165
+ | `eigenpal agents dataset validate [options] [path]` | Validate a local dataset directory against the agent input/output schemas. |
230
166
 
231
167
  ### Experiment
232
168
 
233
- | Command | Description |
234
- | ------------------------------------------------------------------------------------------ | ----------------------------------------------- |
235
- | `eigenpal agents\|agent experiment\|exp run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
236
- | `eigenpal agents\|agent experiment\|exp status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
237
- | `eigenpal agents\|agent experiment\|exp results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
238
- | `eigenpal agents\|agent experiment\|exp list\|ls [options] <agent-id-or-slug>` | List experiments. |
239
- | `eigenpal agents\|agent experiment\|exp compare\|diff [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
240
- | `eigenpal agents\|agent experiment\|exp cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
169
+ | Command | Description |
170
+ | ----------------------------------------------------------------------------------- | ----------------------------------------------- |
171
+ | `eigenpal agents experiment\|exp run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
172
+ | `eigenpal agents experiment\|exp status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
173
+ | `eigenpal agents experiment\|exp results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
174
+ | `eigenpal agents experiment\|exp list\|ls [options] <agent-id-or-slug>` | List experiments. |
175
+ | `eigenpal agents experiment\|exp compare\|diff [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
176
+ | `eigenpal agents experiment\|exp cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
241
177
 
242
178
  ### Session
243
179
 
244
- | Command | Description |
245
- | ---------------------------------------------------------------------- | -------------------------------------- |
246
- | `eigenpal agents\|agent session list\|ls [options] <agent-id-or-slug>` | List builder sessions for an agent. |
247
- | `eigenpal agents\|agent session get [options] <session-id>` | Get a builder session and messages. |
248
- | `eigenpal agents\|agent session start [options] <agent-id-or-slug>` | Start a builder session. |
249
- | `eigenpal agents\|agent session message [options] <session-id>` | Append a message to a builder session. |
250
- | `eigenpal agents\|agent session stop [options] <session-id>` | Stop a builder session. |
180
+ | Command | Description |
181
+ | --------------------------------------------------------------- | -------------------------------------- |
182
+ | `eigenpal agents session list\|ls [options] <agent-id-or-slug>` | List builder sessions for an agent. |
183
+ | `eigenpal agents session get [options] <session-id>` | Get a builder session and messages. |
184
+ | `eigenpal agents session start [options] <agent-id-or-slug>` | Start a builder session. |
185
+ | `eigenpal agents session message [options] <session-id>` | Append a message to a builder session. |
186
+ | `eigenpal agents session stop [options] <session-id>` | Stop a builder session. |
251
187
 
252
188
  ### Env
253
189
 
254
- | Command | Description |
255
- | ---------------------------------------------------- | ----------------------------------------------- |
256
- | `eigenpal agents\|agent env pull [options] [target]` | Decrypt source secrets and print shell exports. |
190
+ | Command | Description |
191
+ | --------------------------------------------- | ----------------------------------------------- |
192
+ | `eigenpal agents env pull [options] [target]` | Decrypt source secrets and print shell exports. |
257
193
 
258
194
  ### Secrets
259
195
 
260
- | Command | Description |
261
- | ---------------------------------------------------------- | ----------------------------------------------- |
262
- | `eigenpal agents\|agent secrets export [options] [target]` | Decrypt source secrets and print shell exports. |
196
+ | Command | Description |
197
+ | --------------------------------------------------- | ----------------------------------------------- |
198
+ | `eigenpal agents secrets export [options] [target]` | Decrypt source secrets and print shell exports. |
263
199
 
264
200
  ## Details
265
201
 
266
- ### `eigenpal agents|agent run [options] <target>`
202
+ ### `eigenpal agents run [options] <target>`
267
203
 
268
204
  Run an agent target, e.g. agents.invoice-agent@latest.
269
205
 
@@ -286,28 +222,7 @@ Run an agent target, e.g. agents.invoice-agent@latest.
286
222
  | `--interval <seconds>` | no | `2` | Polling interval in seconds |
287
223
  | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
288
224
 
289
- ### `eigenpal agents|agent rerun [options] <run-id>`
290
-
291
- Create a new run from a previous run's stored input snapshot.
292
-
293
- ### Arguments
294
-
295
- | Name | Required | Variadic | Description |
296
- | -------- | -------- | -------- | ----------- |
297
- | `run-id` | yes | no | |
298
-
299
- ### Options
300
-
301
- | Flag | Required | Default | Description |
302
- | ---------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------- |
303
- | `--base-url <url>` | no | | Server base URL |
304
- | `--json` | no | | Output the raw server response as JSON |
305
- | `--source-ref <ref>` | no | | Source ref for the new run (default: latest). Use "original" to reproduce the previous resolved version. |
306
- | `--wait` | no | | Poll until the rerun reaches a terminal status |
307
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
308
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
309
-
310
- ### `eigenpal agents|agent list|ls [options]`
225
+ ### `eigenpal agents list|ls [options]`
311
226
 
312
227
  List agents.
313
228
 
@@ -321,7 +236,7 @@ List agents.
321
236
  | `--json` | no | | Output the raw server response as JSON |
322
237
  | `--search <q>` | no | | Search by slug, name, or description |
323
238
 
324
- ### `eigenpal agents|agent validate [options] [dir]`
239
+ ### `eigenpal agents validate [options] [dir]`
325
240
 
326
241
  Validate a local agent package (layout, manifest, schemas, and Git source rules).
327
242
 
@@ -337,7 +252,7 @@ Validate a local agent package (layout, manifest, schemas, and Git source rules)
337
252
  | -------- | -------- | ------- | -------------------------------------- |
338
253
  | `--json` | no | | Output the raw server response as JSON |
339
254
 
340
- ### `eigenpal agents|agent clone [options]`
255
+ ### `eigenpal agents clone [options]`
341
256
 
342
257
  Clone the organization source repository.
343
258
 
@@ -349,7 +264,7 @@ Clone the organization source repository.
349
264
  | `--out <dir>` | no | | Output directory |
350
265
  | `--tenant-id <tenantId>` | no | | Target tenant id for admin-token source clones |
351
266
 
352
- ### `eigenpal agents|agent install [options] [packageRef]`
267
+ ### `eigenpal agents install [options] [packageRef]`
353
268
 
354
269
  Materialize a source package and its workspace dependencies.
355
270
 
@@ -369,7 +284,7 @@ Materialize a source package and its workspace dependencies.
369
284
  | `--frozen-lockfile` | no | | Install exactly from the existing lockfile |
370
285
  | `--remote-url <url>` | no | | Use an explicit organization Git remote URL |
371
286
 
372
- ### `eigenpal agents|agent init [options] <name>`
287
+ ### `eigenpal agents init [options] <name>`
373
288
 
374
289
  Create a new source package scaffold.
375
290
 
@@ -386,9 +301,9 @@ Create a new source package scaffold.
386
301
  | `--template <template>` | yes | | Package template |
387
302
  | `--dir <dir>` | no | | Repository directory |
388
303
 
389
- ### `eigenpal agents|agent pull [options]`
304
+ ### `eigenpal agents pull [options]`
390
305
 
391
- Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs artifacts fetch.
306
+ Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use runs artifacts fetch.
392
307
 
393
308
  ### Options
394
309
 
@@ -397,7 +312,7 @@ Pull organization source from origin/main with --ff-only. For datasets use agent
397
312
  | `--base-url <url>` | no | | Server base URL |
398
313
  | `--dir <dir>` | no | | Repository directory |
399
314
 
400
- ### `eigenpal agents|agent commit [options]`
315
+ ### `eigenpal agents commit [options]`
401
316
 
402
317
  Validate changed source packages and commit them.
403
318
 
@@ -409,7 +324,7 @@ Validate changed source packages and commit them.
409
324
  | `-m, --message <message>` | yes | | Commit message |
410
325
  | `--dir <dir>` | no | | Repository directory |
411
326
 
412
- ### `eigenpal agents|agent save [options]`
327
+ ### `eigenpal agents save [options]`
413
328
 
414
329
  Validate, commit if dirty, and push the current source branch.
415
330
 
@@ -421,7 +336,7 @@ Validate, commit if dirty, and push the current source branch.
421
336
  | `-m, --message <message>` | no | | Commit message when source changes are dirty |
422
337
  | `--dir <dir>` | no | | Repository directory |
423
338
 
424
- ### `eigenpal agents|agent push [options]`
339
+ ### `eigenpal agents push [options]`
425
340
 
426
341
  Push the current organization source branch and tags.
427
342
 
@@ -432,7 +347,7 @@ Push the current organization source branch and tags.
432
347
  | `--base-url <url>` | no | | Server base URL |
433
348
  | `--dir <dir>` | no | | Repository directory |
434
349
 
435
- ### `eigenpal agents|agent upgrade [options]`
350
+ ### `eigenpal agents upgrade [options]`
436
351
 
437
352
  Upgrade the source repository schema in place.
438
353
 
@@ -443,7 +358,7 @@ Upgrade the source repository schema in place.
443
358
  | `--dir <dir>` | no | | Repository directory |
444
359
  | `--dry-run` | no | | Print upgrade actions without changing files |
445
360
 
446
- ### `eigenpal agents|agent doctor [options]`
361
+ ### `eigenpal agents doctor [options]`
447
362
 
448
363
  Check organization source repository health.
449
364
 
@@ -454,7 +369,7 @@ Check organization source repository health.
454
369
  | `--json` | no | | Output the raw server response as JSON |
455
370
  | `--dir <dir>` | no | | Directory to inspect |
456
371
 
457
- ### `eigenpal agents|agent status [options]`
372
+ ### `eigenpal agents status [options]`
458
373
 
459
374
  Show source repo and package status.
460
375
 
@@ -465,7 +380,7 @@ Show source repo and package status.
465
380
  | `--json` | no | | Output the raw server response as JSON |
466
381
  | `--dir <dir>` | no | | Directory to inspect |
467
382
 
468
- ### `eigenpal agents|agent deps [options]`
383
+ ### `eigenpal agents deps [options]`
469
384
 
470
385
  List package workspace dependencies.
471
386
 
@@ -476,7 +391,7 @@ List package workspace dependencies.
476
391
  | `--json` | no | | Output the raw server response as JSON |
477
392
  | `--dir <dir>` | no | | Directory to inspect |
478
393
 
479
- ### `eigenpal agents|agent clean [options]`
394
+ ### `eigenpal agents clean [options]`
480
395
 
481
396
  Require a clean source working tree.
482
397
 
@@ -486,7 +401,7 @@ Require a clean source working tree.
486
401
  | ------------- | -------- | ------- | -------------------- |
487
402
  | `--dir <dir>` | no | | Directory to inspect |
488
403
 
489
- ### `eigenpal agents|agent show [options] <automation>`
404
+ ### `eigenpal agents show [options] <automation>`
490
405
 
491
406
  Show Git-backed automation details.
492
407
 
@@ -503,7 +418,7 @@ Show Git-backed automation details.
503
418
  | `--base-url <url>` | no | | Server base URL |
504
419
  | `--json` | no | | Output the raw server response as JSON |
505
420
 
506
- ### `eigenpal agents|agent versions [options] <package>`
421
+ ### `eigenpal agents versions [options] <package>`
507
422
 
508
423
  List package release versions.
509
424
 
@@ -520,7 +435,7 @@ List package release versions.
520
435
  | `--base-url <url>` | no | | Server base URL |
521
436
  | `--json` | no | | Output the raw server response as JSON |
522
437
 
523
- ### `eigenpal agents|agent release [options] <version> [dir]`
438
+ ### `eigenpal agents release [options] <version> [dir]`
524
439
 
525
440
  Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead.
526
441
 
@@ -538,7 +453,7 @@ Create and push an immutable package release tag. Never move or overwrite an exi
538
453
  | `--base-url <url>` | no | | Server base URL |
539
454
  | `-m, --message <message>` | no | | Annotated tag message (default: Release <packagePath>) |
540
455
 
541
- ### `eigenpal agents|agent sync [options] [automation]`
456
+ ### `eigenpal agents sync [options] [automation]`
542
457
 
543
458
  Sync an automation from the latest Git source release.
544
459
 
@@ -555,7 +470,7 @@ Sync an automation from the latest Git source release.
555
470
  | `--base-url <url>` | no | | Server base URL |
556
471
  | `--dir <dir>` | no | | Directory to inspect |
557
472
 
558
- ### `eigenpal agents|agent file list|ls [options] <agent-id-or-slug>`
473
+ ### `eigenpal agents file list|ls [options] <agent-id-or-slug>`
559
474
 
560
475
  List live files for an agent.
561
476
 
@@ -573,7 +488,7 @@ List live files for an agent.
573
488
  | `--json` | no | | Output the raw server response as JSON |
574
489
  | `--path <prefix>` | no | | Only list files beneath this relative path |
575
490
 
576
- ### `eigenpal agents|agent file get [options] <agent-id-or-slug> <remote-path>`
491
+ ### `eigenpal agents file get [options] <agent-id-or-slug> <remote-path>`
577
492
 
578
493
  Download one live agent file.
579
494
 
@@ -592,7 +507,7 @@ Download one live agent file.
592
507
  | `--json` | no | | Output the raw server response as JSON |
593
508
  | `--out <file>` | no | | Output file path |
594
509
 
595
- ### `eigenpal agents|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
510
+ ### `eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
596
511
 
597
512
  Compare one live agent file against a local file.
598
513
 
@@ -611,7 +526,7 @@ Compare one live agent file against a local file.
611
526
  | `--base-url <url>` | no | | Server base URL |
612
527
  | `--json` | no | | Output the raw server response as JSON |
613
528
 
614
- ### `eigenpal agents|agent secret set [options] <name>`
529
+ ### `eigenpal agents secret set [options] <name>`
615
530
 
616
531
  Encrypt and set a secret value in secrets.enc.yaml.
617
532
 
@@ -630,7 +545,7 @@ Encrypt and set a secret value in secrets.enc.yaml.
630
545
  | `--value-file <path>` | no | | Read the secret value from a file |
631
546
  | `--description <text>` | no | | Secret description |
632
547
 
633
- ### `eigenpal agents|agent secret unset [options] <name>`
548
+ ### `eigenpal agents secret unset [options] <name>`
634
549
 
635
550
  Remove a secret from secrets.enc.yaml.
636
551
 
@@ -646,7 +561,7 @@ Remove a secret from secrets.enc.yaml.
646
561
  | ------------- | -------- | ------- | -------------------- |
647
562
  | `--dir <dir>` | no | | Directory to inspect |
648
563
 
649
- ### `eigenpal agents|agent secret import [options] <env-file>`
564
+ ### `eigenpal agents secret import [options] <env-file>`
650
565
 
651
566
  Import KEY=value entries from an env file into secrets.enc.yaml.
652
567
 
@@ -662,7 +577,7 @@ Import KEY=value entries from an env file into secrets.enc.yaml.
662
577
  | ------------- | -------- | ------- | -------------------- |
663
578
  | `--dir <dir>` | no | | Directory to inspect |
664
579
 
665
- ### `eigenpal agents|agent dataset list|ls [options] <agent-id-or-slug>`
580
+ ### `eigenpal agents dataset list|ls [options] <agent-id-or-slug>`
666
581
 
667
582
  List dataset examples for an agent.
668
583
 
@@ -681,7 +596,7 @@ List dataset examples for an agent.
681
596
  | `--offset <n>` | no | `0` | Page offset |
682
597
  | `--json` | no | | Output the raw server response as JSON |
683
598
 
684
- ### `eigenpal agents|agent dataset push [options] <agent-id-or-slug>`
599
+ ### `eigenpal agents dataset push [options] <agent-id-or-slug>`
685
600
 
686
601
  Upload dataset examples from a local dataset directory.
687
602
 
@@ -701,7 +616,7 @@ Upload dataset examples from a local dataset directory.
701
616
  | `--mode <append\|replace>` | no | `"append"` | Upload mode |
702
617
  | `--yes` | no | | Confirm replace mode in non-interactive environments |
703
618
 
704
- ### `eigenpal agents|agent dataset pull [options] <agent-id-or-slug>`
619
+ ### `eigenpal agents dataset pull [options] <agent-id-or-slug>`
705
620
 
706
621
  Download an agent dataset directory.
707
622
 
@@ -718,7 +633,7 @@ Download an agent dataset directory.
718
633
  | `--base-url <url>` | no | | Server base URL |
719
634
  | `--out <dir>` | no | `"dataset"` | Output directory |
720
635
 
721
- ### `eigenpal agents|agent dataset validate [options] [path]`
636
+ ### `eigenpal agents dataset validate [options] [path]`
722
637
 
723
638
  Validate a local dataset directory against the agent input/output schemas.
724
639
 
@@ -735,335 +650,7 @@ Validate a local dataset directory against the agent input/output schemas.
735
650
  | `--json` | no | | Output the raw server response as JSON |
736
651
  | `--agent-dir <dir>` | no | `"."` | Agent package directory containing input/output schemas |
737
652
 
738
- ### `eigenpal agents|agent runs list|ls [options] <target>`
739
-
740
- List runs for an agent target; unqualified targets include all source refs.
741
-
742
- ### Arguments
743
-
744
- | Name | Required | Variadic | Description |
745
- | -------- | -------- | -------- | ----------- |
746
- | `target` | yes | no | |
747
-
748
- ### Options
749
-
750
- | Flag | Required | Default | Description |
751
- | --------------------- | -------- | ------- | -------------------------------------- |
752
- | `--base-url <url>` | no | | Server base URL |
753
- | `--limit <n>` | no | `50` | Page size |
754
- | `--offset <n>` | no | `0` | Page offset |
755
- | `--json` | no | | Output the raw server response as JSON |
756
- | `--status <status>` | no | | Filter by run status |
757
- | `--include <items>` | no | | Comma-separated include list |
758
- | `--compact` | no | | Render compact run rows |
759
- | `--sort <field>` | no | | Sort field |
760
- | `--order <asc\|desc>` | no | | Sort order |
761
-
762
- ### `eigenpal agents|agent runs get [options] <run-id>`
763
-
764
- Get one agent run.
765
-
766
- ### Arguments
767
-
768
- | Name | Required | Variadic | Description |
769
- | -------- | -------- | -------- | ----------- |
770
- | `run-id` | yes | no | |
771
-
772
- ### Options
773
-
774
- | Flag | Required | Default | Description |
775
- | ------------------- | -------- | ------------ | ----------------------------------------------------------------- |
776
- | `--base-url <url>` | no | | Server base URL |
777
- | `--json` | no | | Output the raw server response as JSON |
778
- | `--include <parts>` | no | `"feedback"` | Comma-separated extra parts: feedback,expected,files,trace,issues |
779
-
780
- ### `eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`
781
-
782
- Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
783
-
784
- ### Arguments
785
-
786
- | Name | Required | Variadic | Description |
787
- | ------------------ | -------- | -------- | ----------- |
788
- | `reference-run-id` | yes | no | |
789
- | `run-id` | yes | no | |
790
-
791
- ### Options
792
-
793
- | Flag | Required | Default | Description |
794
- | ------------------- | -------- | ------- | ------------------------------------------------------------------- |
795
- | `--base-url <url>` | no | | Server base URL |
796
- | `--json` | no | | Output the raw server response as JSON |
797
- | `--baseline` | no | | Compare actual outputs from both runs instead of expected artifacts |
798
- | `--out <dir>` | no | | Write comparison artifacts to this directory |
799
- | `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
800
- | `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
801
-
802
- ### `eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`
803
-
804
- List available run artifacts without downloading them.
805
-
806
- ### Arguments
807
-
808
- | Name | Required | Variadic | Description |
809
- | -------- | -------- | -------- | ----------- |
810
- | `run-id` | yes | no | |
811
-
812
- ### Options
813
-
814
- | Flag | Required | Default | Description |
815
- | ------------------ | -------- | ------- | -------------------------------------- |
816
- | `--base-url <url>` | no | | Server base URL |
817
- | `--json` | no | | Output the raw server response as JSON |
818
-
819
- ### `eigenpal agents|agent runs artifacts|artifact fetch [options] <run-id>`
820
-
821
- Download run artifacts by canonical artifact path.
822
-
823
- ### Arguments
824
-
825
- | Name | Required | Variadic | Description |
826
- | -------- | -------- | -------- | ----------- |
827
- | `run-id` | yes | no | |
828
-
829
- ### Options
830
-
831
- | Flag | Required | Default | Description |
832
- | ------------------- | -------- | ------- | ------------------------------------------------------------------------------- |
833
- | `--base-url <url>` | no | | Server base URL |
834
- | `--out <dir>` | no | | Output directory |
835
- | `--include <parts>` | no | `"all"` | Comma-separated parts: output,input,metadata,issues,trace,lockfile,expected,all |
836
- | `--path <path>` | no | `[]` | Fetch one exact artifact path from `artifacts list`; repeatable |
837
- | `--json` | no | | Output a JSON summary of written artifacts |
838
-
839
- ### `eigenpal agents|agent runs trace [options] <run-id>`
840
-
841
- Print raw trace.jsonl for a run, or write it with --out.
842
-
843
- ### Arguments
844
-
845
- | Name | Required | Variadic | Description |
846
- | -------- | -------- | -------- | ----------- |
847
- | `run-id` | yes | no | |
848
-
849
- ### Options
850
-
851
- | Flag | Required | Default | Description |
852
- | ------------------ | -------- | ------- | ---------------- |
853
- | `--base-url <url>` | no | | Server base URL |
854
- | `--out <file>` | no | | Output file path |
855
-
856
- ### `eigenpal agents|agent runs feedback|fb update [options] <run-id>`
857
-
858
- Edit feedback state, rating, message, or expected JSON for a run.
859
-
860
- ### Arguments
861
-
862
- | Name | Required | Variadic | Description |
863
- | -------- | -------- | -------- | ----------- |
864
- | `run-id` | yes | no | |
865
-
866
- ### Options
867
-
868
- | Flag | Required | Default | Description |
869
- | -------------------------------------- | -------- | ------- | ----------------------------------------- |
870
- | `--base-url <url>` | no | | Server base URL |
871
- | `--json` | no | | Output the raw server response as JSON |
872
- | `--status <open\|resolved\|ignored>` | no | | Set feedback status |
873
- | `--rating <pass\|fail\|partial\|none>` | no | | Set feedback rating |
874
- | `--message <text>` | no | | Set feedback message body |
875
- | `--message-file <path>` | no | | Read feedback message body from a file |
876
- | `--expected-json <json>` | no | | Set structured expected JSON |
877
- | `--expected-json-file <path>` | no | | Read structured expected JSON from a file |
878
- | `--clear-message` | no | | Clear the feedback message body |
879
- | `--clear-rating` | no | | Clear feedback rating |
880
- | `--clear-expected-json` | no | | Delete structured expected JSON |
881
-
882
- ### `eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`
883
-
884
- Mark run feedback as resolved.
885
-
886
- ### Arguments
887
-
888
- | Name | Required | Variadic | Description |
889
- | -------- | -------- | -------- | ----------- |
890
- | `run-id` | yes | no | |
891
-
892
- ### Options
893
-
894
- | Flag | Required | Default | Description |
895
- | ----------------------- | -------- | ------- | -------------------------------------- |
896
- | `--base-url <url>` | no | | Server base URL |
897
- | `--json` | no | | Output the raw server response as JSON |
898
- | `--message <text>` | no | | Set feedback message body |
899
- | `--message-file <path>` | no | | Read feedback message body from a file |
900
-
901
- ### `eigenpal agents|agent runs feedback|fb clear [options] <run-id>`
902
-
903
- Delete feedback, expected.json, and expected files for a run.
904
-
905
- ### Arguments
906
-
907
- | Name | Required | Variadic | Description |
908
- | -------- | -------- | -------- | ----------- |
909
- | `run-id` | yes | no | |
910
-
911
- ### Options
912
-
913
- | Flag | Required | Default | Description |
914
- | ------------------ | -------- | ------- | ---------------------------------------- |
915
- | `--base-url <url>` | no | | Server base URL |
916
- | `--json` | no | | Output the raw server response as JSON |
917
- | `--yes` | no | | Required in non-interactive environments |
918
-
919
- ### `eigenpal agents|agent runs expected list|ls [options] <run-id>`
920
-
921
- List expected JSON and files attached to a run.
922
-
923
- ### Arguments
924
-
925
- | Name | Required | Variadic | Description |
926
- | -------- | -------- | -------- | ----------- |
927
- | `run-id` | yes | no | |
928
-
929
- ### Options
930
-
931
- | Flag | Required | Default | Description |
932
- | ------------------ | -------- | ------- | -------------------------------------- |
933
- | `--base-url <url>` | no | | Server base URL |
934
- | `--json` | no | | Output the raw server response as JSON |
935
-
936
- ### `eigenpal agents|agent runs expected pull [options] <run-id>`
937
-
938
- Download expected JSON and files attached to a run.
939
-
940
- ### Arguments
941
-
942
- | Name | Required | Variadic | Description |
943
- | -------- | -------- | -------- | ----------- |
944
- | `run-id` | yes | no | |
945
-
946
- ### Options
947
-
948
- | Flag | Required | Default | Description |
949
- | ------------------ | -------- | ------- | ---------------- |
950
- | `--base-url <url>` | no | | Server base URL |
951
- | `--out <dir>` | no | | Output directory |
952
-
953
- ### `eigenpal agents|agent runs expected upload [options] <run-id> <file>`
954
-
955
- Upload a local file as an expected artifact.
956
-
957
- ### Arguments
958
-
959
- | Name | Required | Variadic | Description |
960
- | -------- | -------- | -------- | ----------- |
961
- | `run-id` | yes | no | |
962
- | `file` | yes | no | |
963
-
964
- ### Options
965
-
966
- | Flag | Required | Default | Description |
967
- | ------------------ | -------- | ------- | -------------------------------------- |
968
- | `--base-url <url>` | no | | Server base URL |
969
- | `--json` | no | | Output the raw server response as JSON |
970
- | `--name <name>` | no | | Expected artifact name |
971
-
972
- ### `eigenpal agents|agent runs expected copy-output [options] <run-id> <output-file>`
973
-
974
- Copy a generated output file into expected artifacts.
975
-
976
- ### Arguments
977
-
978
- | Name | Required | Variadic | Description |
979
- | ------------- | -------- | -------- | ----------- |
980
- | `run-id` | yes | no | |
981
- | `output-file` | yes | no | |
982
-
983
- ### Options
984
-
985
- | Flag | Required | Default | Description |
986
- | ------------------ | -------- | ------- | -------------------------------------- |
987
- | `--base-url <url>` | no | | Server base URL |
988
- | `--json` | no | | Output the raw server response as JSON |
989
- | `--name <name>` | no | | Expected artifact name |
990
-
991
- ### `eigenpal agents|agent runs expected rename [options] <run-id> <old-name> <new-name>`
992
-
993
- Rename an expected artifact.
994
-
995
- ### Arguments
996
-
997
- | Name | Required | Variadic | Description |
998
- | ---------- | -------- | -------- | ----------- |
999
- | `run-id` | yes | no | |
1000
- | `old-name` | yes | no | |
1001
- | `new-name` | yes | no | |
1002
-
1003
- ### Options
1004
-
1005
- | Flag | Required | Default | Description |
1006
- | ------------------ | -------- | ------- | -------------------------------------- |
1007
- | `--base-url <url>` | no | | Server base URL |
1008
- | `--json` | no | | Output the raw server response as JSON |
1009
-
1010
- ### `eigenpal agents|agent runs expected delete [options] <run-id> <name>`
1011
-
1012
- Delete an expected artifact.
1013
-
1014
- ### Arguments
1015
-
1016
- | Name | Required | Variadic | Description |
1017
- | -------- | -------- | -------- | ----------- |
1018
- | `run-id` | yes | no | |
1019
- | `name` | yes | no | |
1020
-
1021
- ### Options
1022
-
1023
- | Flag | Required | Default | Description |
1024
- | ------------------ | -------- | ------- | ---------------------------------------- |
1025
- | `--base-url <url>` | no | | Server base URL |
1026
- | `--json` | no | | Output the raw server response as JSON |
1027
- | `--yes` | no | | Required in non-interactive environments |
1028
-
1029
- ### `eigenpal agents|agent runs watch [options] <run-id>`
1030
-
1031
- Watch a run until it reaches a terminal status.
1032
-
1033
- ### Arguments
1034
-
1035
- | Name | Required | Variadic | Description |
1036
- | -------- | -------- | -------- | ----------- |
1037
- | `run-id` | yes | no | |
1038
-
1039
- ### Options
1040
-
1041
- | Flag | Required | Default | Description |
1042
- | ---------------------- | -------- | ------- | -------------------------------------- |
1043
- | `--base-url <url>` | no | | Server base URL |
1044
- | `--json` | no | | Output the raw server response as JSON |
1045
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
1046
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
1047
-
1048
- ### `eigenpal agents|agent runs cancel [options] <run-id>`
1049
-
1050
- Cancel an agent run.
1051
-
1052
- ### Arguments
1053
-
1054
- | Name | Required | Variadic | Description |
1055
- | -------- | -------- | -------- | ----------- |
1056
- | `run-id` | yes | no | |
1057
-
1058
- ### Options
1059
-
1060
- | Flag | Required | Default | Description |
1061
- | ------------------ | -------- | ------- | ---------------------------------------- |
1062
- | `--base-url <url>` | no | | Server base URL |
1063
- | `--json` | no | | Output the raw server response as JSON |
1064
- | `--yes` | no | | Required in non-interactive environments |
1065
-
1066
- ### `eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`
653
+ ### `eigenpal agents experiment|exp run [options] <agent-id-or-slug>`
1067
654
 
1068
655
  Start an experiment over dataset examples.
1069
656
 
@@ -1083,7 +670,7 @@ Start an experiment over dataset examples.
1083
670
  | `--wait` | no | | Poll until the experiment reaches a terminal status |
1084
671
  | `--interval <seconds>` | no | `2` | Polling interval in seconds |
1085
672
 
1086
- ### `eigenpal agents|agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`
673
+ ### `eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id>`
1087
674
 
1088
675
  Get experiment status.
1089
676
 
@@ -1105,7 +692,7 @@ Get experiment status.
1105
692
  | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
1106
693
  | `--include <parts>` | no | | Reserved for future detailed parts |
1107
694
 
1108
- ### `eigenpal agents|agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`
695
+ ### `eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id]`
1109
696
 
1110
697
  Print experiment results as JSON or CSV.
1111
698
 
@@ -1124,7 +711,7 @@ Print experiment results as JSON or CSV.
1124
711
  | `--format <csv\|json>` | yes | | Output format |
1125
712
  | `--out <path>` | no | | Write output to file |
1126
713
 
1127
- ### `eigenpal agents|agent experiment|exp list|ls [options] <agent-id-or-slug>`
714
+ ### `eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug>`
1128
715
 
1129
716
  List experiments.
1130
717
 
@@ -1144,7 +731,7 @@ List experiments.
1144
731
  | `--json` | no | | Output the raw server response as JSON |
1145
732
  | `--batch-id <id>` | no | | Filter to one batch id |
1146
733
 
1147
- ### `eigenpal agents|agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`
734
+ ### `eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`
1148
735
 
1149
736
  Compare two experiment batches.
1150
737
 
@@ -1164,7 +751,7 @@ Compare two experiment batches.
1164
751
  | `--sort <mode>` | no | | Accepted for compatibility; sorting happens client-side later |
1165
752
  | `--regression-threshold <n>` | no | | Accepted for compatibility |
1166
753
 
1167
- ### `eigenpal agents|agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`
754
+ ### `eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`
1168
755
 
1169
756
  Cancel every active execution in an experiment.
1170
757
 
@@ -1183,7 +770,7 @@ Cancel every active execution in an experiment.
1183
770
  | `--json` | no | | Output the raw server response as JSON |
1184
771
  | `--yes` | no | | Required in non-interactive environments |
1185
772
 
1186
- ### `eigenpal agents|agent session list|ls [options] <agent-id-or-slug>`
773
+ ### `eigenpal agents session list|ls [options] <agent-id-or-slug>`
1187
774
 
1188
775
  List builder sessions for an agent.
1189
776
 
@@ -1202,7 +789,7 @@ List builder sessions for an agent.
1202
789
  | `--offset <n>` | no | `0` | Page offset |
1203
790
  | `--json` | no | | Output the raw server response as JSON |
1204
791
 
1205
- ### `eigenpal agents|agent session get [options] <session-id>`
792
+ ### `eigenpal agents session get [options] <session-id>`
1206
793
 
1207
794
  Get a builder session and messages.
1208
795
 
@@ -1219,7 +806,7 @@ Get a builder session and messages.
1219
806
  | `--base-url <url>` | no | | Server base URL |
1220
807
  | `--json` | no | | Output the raw server response as JSON |
1221
808
 
1222
- ### `eigenpal agents|agent session start [options] <agent-id-or-slug>`
809
+ ### `eigenpal agents session start [options] <agent-id-or-slug>`
1223
810
 
1224
811
  Start a builder session.
1225
812
 
@@ -1237,7 +824,7 @@ Start a builder session.
1237
824
  | `--json` | no | | Output the raw server response as JSON |
1238
825
  | `--title <title>` | no | | Session title |
1239
826
 
1240
- ### `eigenpal agents|agent session message [options] <session-id>`
827
+ ### `eigenpal agents session message [options] <session-id>`
1241
828
 
1242
829
  Append a message to a builder session.
1243
830
 
@@ -1256,7 +843,7 @@ Append a message to a builder session.
1256
843
  | `--text <message>` | yes | | Message text |
1257
844
  | `--wait` | no | | Reserved; server acknowledges after enqueueing the message |
1258
845
 
1259
- ### `eigenpal agents|agent session stop [options] <session-id>`
846
+ ### `eigenpal agents session stop [options] <session-id>`
1260
847
 
1261
848
  Stop a builder session.
1262
849
 
@@ -1274,7 +861,7 @@ Stop a builder session.
1274
861
  | `--json` | no | | Output the raw server response as JSON |
1275
862
  | `--yes` | no | | Required in non-interactive environments |
1276
863
 
1277
- ### `eigenpal agents|agent env pull [options] [target]`
864
+ ### `eigenpal agents env pull [options] [target]`
1278
865
 
1279
866
  Decrypt source secrets and print shell exports.
1280
867
 
@@ -1292,7 +879,7 @@ Decrypt source secrets and print shell exports.
1292
879
  | `--dir <dir>` | no | `"."` | Installed agent package directory |
1293
880
  | `--format <format>` | no | `"shell"` | Output format: shell or dotenv |
1294
881
 
1295
- ### `eigenpal agents|agent secrets export [options] [target]`
882
+ ### `eigenpal agents secrets export [options] [target]`
1296
883
 
1297
884
  Decrypt source secrets and print shell exports.
1298
885