@eigenpal/cli 0.5.11 → 0.6.0

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.
Files changed (18) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +3 -1
  3. package/dist/cli.js +50602 -43044
  4. package/dist/skill/SKILL.md +152 -76
  5. package/dist/skill/reference/cli/agents.md +1330 -0
  6. package/dist/skill/reference/cli/auth.md +2 -2
  7. package/dist/skill/reference/cli/git.md +5 -3
  8. package/dist/skill/reference/cli/init.md +8 -2
  9. package/dist/skill/reference/cli/run.md +18 -0
  10. package/dist/skill/reference/cli/runs.md +23 -0
  11. package/dist/skill/reference/cli/skill.md +2 -2
  12. package/dist/skill/reference/cli/workflow.md +29 -29
  13. package/dist/skill/reference/dataset-format.md +63 -9
  14. package/dist/skill/reference/evaluators.md +8 -1
  15. package/dist/skill/reference/step-types.md +300 -18
  16. package/dist/skill/reference/workflow-yaml.md +2 -1
  17. package/package.json +1 -1
  18. package/dist/skill/reference/cli/agent.md +0 -1243
package/dist/skill/reference/cli/agents.md ADDED
@@ -0,0 +1,1330 @@
1
+ # eigenpal agents
2
+
3
+ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and releases.
4
+
5
+ ## Contents
6
+
7
+ - [Surface](#surface)
8
+ - [Commands](#commands)
9
+ - [Core](#core)
10
+ - [File](#file)
11
+ - [Secret](#secret)
12
+ - [Dataset](#dataset)
13
+ - [Runs](#runs)
14
+ - [Experiment](#experiment)
15
+ - [Session](#session)
16
+ - [Env](#env)
17
+ - [Secrets](#secrets)
18
+ - [Details](#details)
19
+ - [`eigenpal agents|agent run [options] <target>`](#eigenpal-agentsagent-run-options-target)
20
+ - [`eigenpal agents|agent list|ls [options]`](#eigenpal-agentsagent-listls-options)
21
+ - [`eigenpal agents|agent validate [options] [dir]`](#eigenpal-agentsagent-validate-options-dir)
22
+ - [`eigenpal agents|agent clone [options]`](#eigenpal-agentsagent-clone-options)
23
+ - [`eigenpal agents|agent install [options] [packageRef]`](#eigenpal-agentsagent-install-options-packageref)
24
+ - [`eigenpal agents|agent init [options] <name>`](#eigenpal-agentsagent-init-options-name)
25
+ - [`eigenpal agents|agent pull [options]`](#eigenpal-agentsagent-pull-options)
26
+ - [`eigenpal agents|agent commit [options]`](#eigenpal-agentsagent-commit-options)
27
+ - [`eigenpal agents|agent save [options]`](#eigenpal-agentsagent-save-options)
28
+ - [`eigenpal agents|agent push [options]`](#eigenpal-agentsagent-push-options)
29
+ - [`eigenpal agents|agent upgrade [options]`](#eigenpal-agentsagent-upgrade-options)
30
+ - [`eigenpal agents|agent doctor [options]`](#eigenpal-agentsagent-doctor-options)
31
+ - [`eigenpal agents|agent status [options]`](#eigenpal-agentsagent-status-options)
32
+ - [`eigenpal agents|agent deps [options]`](#eigenpal-agentsagent-deps-options)
33
+ - [`eigenpal agents|agent clean [options]`](#eigenpal-agentsagent-clean-options)
34
+ - [`eigenpal agents|agent show [options] <automation>`](#eigenpal-agentsagent-show-options-automation)
35
+ - [`eigenpal agents|agent versions [options] <package>`](#eigenpal-agentsagent-versions-options-package)
36
+ - [`eigenpal agents|agent release [options] <version> [dir]`](#eigenpal-agentsagent-release-options-version-dir)
37
+ - [`eigenpal agents|agent sync [options] [automation]`](#eigenpal-agentsagent-sync-options-automation)
38
+ - [`eigenpal agents|agent file list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-file-listls-options-agent-id-or-slug)
39
+ - [`eigenpal agents|agent file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agentsagent-file-get-options-agent-id-or-slug-remote-path)
40
+ - [`eigenpal agents|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agentsagent-file-put-options-agent-id-or-slug-remote-path-local-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 rerun [options] <run-id>`](#eigenpal-agentsagent-runs-rerun-options-run-id)
52
+ - [`eigenpal agents|agent runs pull [options] <run-id>`](#eigenpal-agentsagent-runs-pull-options-run-id)
53
+ - [`eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`](#eigenpal-agentsagent-runs-comparediff-options-reference-run-id-run-id)
54
+ - [`eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`](#eigenpal-agentsagent-runs-artifactsartifact-listls-options-run-id)
55
+ - [`eigenpal agents|agent runs trace [options] <run-id>`](#eigenpal-agentsagent-runs-trace-options-run-id)
56
+ - [`eigenpal agents|agent runs feedback|fb update [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-update-options-run-id)
57
+ - [`eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-resolve-options-run-id)
58
+ - [`eigenpal agents|agent runs feedback|fb clear [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-clear-options-run-id)
59
+ - [`eigenpal agents|agent runs expected list|ls [options] <run-id>`](#eigenpal-agentsagent-runs-expected-listls-options-run-id)
60
+ - [`eigenpal agents|agent runs expected pull [options] <run-id>`](#eigenpal-agentsagent-runs-expected-pull-options-run-id)
61
+ - [`eigenpal agents|agent runs expected upload [options] <run-id> <file>`](#eigenpal-agentsagent-runs-expected-upload-options-run-id-file)
62
+ - [`eigenpal agents|agent runs expected copy-output [options] <run-id> <output-file>`](#eigenpal-agentsagent-runs-expected-copy-output-options-run-id-output-file)
63
+ - [`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)
64
+ - [`eigenpal agents|agent runs expected delete [options] <run-id> <name>`](#eigenpal-agentsagent-runs-expected-delete-options-run-id-name)
65
+ - [`eigenpal agents|agent runs watch [options] <run-id>`](#eigenpal-agentsagent-runs-watch-options-run-id)
66
+ - [`eigenpal agents|agent runs cancel [options] <run-id>`](#eigenpal-agentsagent-runs-cancel-options-run-id)
67
+ - [`eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-run-options-agent-id-or-slug)
68
+ - [`eigenpal agents|agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-status-options-agent-id-or-slug-batch-id)
69
+ - [`eigenpal agents|agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agentsagent-experimentexp-results-options-agent-id-or-slug-batch-id)
70
+ - [`eigenpal agents|agent experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-listls-options-agent-id-or-slug)
71
+ - [`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)
72
+ - [`eigenpal agents|agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-cancel-options-agent-id-or-slug-batch-id)
73
+ - [`eigenpal agents|agent session list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-listls-options-agent-id-or-slug)
74
+ - [`eigenpal agents|agent session get [options] <session-id>`](#eigenpal-agentsagent-session-get-options-session-id)
75
+ - [`eigenpal agents|agent session start [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-start-options-agent-id-or-slug)
76
+ - [`eigenpal agents|agent session message [options] <session-id>`](#eigenpal-agentsagent-session-message-options-session-id)
77
+ - [`eigenpal agents|agent session stop [options] <session-id>`](#eigenpal-agentsagent-session-stop-options-session-id)
78
+ - [`eigenpal agents|agent env pull [options] [target]`](#eigenpal-agentsagent-env-pull-options-target)
79
+ - [`eigenpal agents|agent secrets export [options] [target]`](#eigenpal-agentsagent-secrets-export-options-target)
80
+
81
+ ## Surface
82
+
83
+ ```
84
+ agents
85
+ ├── run <target>
86
+ ├── list|ls
87
+ ├── file
88
+ │ ├── list|ls <agent-id-or-slug>
89
+ │ ├── get <agent-id-or-slug> <remote-path>
90
+ │ ├── put <agent-id-or-slug> <remote-path> <local-path>
91
+ │ └── diff <agent-id-or-slug> <remote-path> <local-path>
92
+ ├── validate [dir]
93
+ ├── clone
94
+ ├── install [packageRef]
95
+ ├── init <name>
96
+ ├── pull
97
+ ├── commit
98
+ ├── save
99
+ ├── push
100
+ ├── upgrade
101
+ ├── doctor
102
+ ├── status
103
+ ├── deps
104
+ ├── clean
105
+ ├── show <automation>
106
+ ├── versions <package>
107
+ ├── release <version> [dir]
108
+ ├── sync [automation]
109
+ ├── secret
110
+ │ ├── set <name>
111
+ │ ├── unset <name>
112
+ │ └── import <env-file>
113
+ ├── dataset
114
+ │ ├── list|ls <agent-id-or-slug>
115
+ │ ├── push <agent-id-or-slug>
116
+ │ ├── pull <agent-id-or-slug>
117
+ │ └── validate [path]
118
+ ├── runs
119
+ │ ├── list|ls <target>
120
+ │ ├── get <run-id>
121
+ │ ├── rerun <run-id>
122
+ │ ├── pull <run-id>
123
+ │ ├── compare|diff <reference-run-id> <run-id>
124
+ │ ├── artifacts|artifact
125
+ │ │ └── list|ls <run-id>
126
+ │ ├── trace <run-id>
127
+ │ ├── feedback|fb
128
+ │ │ ├── update <run-id>
129
+ │ │ ├── resolve <run-id>
130
+ │ │ └── clear <run-id>
131
+ │ ├── expected
132
+ │ │ ├── list|ls <run-id>
133
+ │ │ ├── pull <run-id>
134
+ │ │ ├── upload <run-id> <file>
135
+ │ │ ├── copy-output <run-id> <output-file>
136
+ │ │ ├── rename <run-id> <old-name> <new-name>
137
+ │ │ └── delete <run-id> <name>
138
+ │ ├── watch <run-id>
139
+ │ └── cancel <run-id>
140
+ ├── experiment|exp
141
+ │ ├── run <agent-id-or-slug>
142
+ │ ├── status <agent-id-or-slug> <batch-id>
143
+ │ ├── results <agent-id-or-slug> [batch-id]
144
+ │ ├── list|ls <agent-id-or-slug>
145
+ │ ├── compare|diff <batch-id-a> <batch-id-b>
146
+ │ └── cancel <agent-id-or-slug> <batch-id>
147
+ ├── session
148
+ │ ├── list|ls <agent-id-or-slug>
149
+ │ ├── get <session-id>
150
+ │ ├── start <agent-id-or-slug>
151
+ │ ├── message <session-id>
152
+ │ └── stop <session-id>
153
+ ├── env
154
+ │ └── pull [target]
155
+ └── secrets
156
+ └── export [target]
157
+ ```
158
+
159
+ ## Commands
160
+
161
+ ### Core
162
+
163
+ | Command | Description |
164
+ | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
165
+ | `eigenpal agents\|agent run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
166
+ | `eigenpal agents\|agent list\|ls [options]` | List agents. |
167
+ | `eigenpal agents\|agent validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
168
+ | `eigenpal agents\|agent clone [options]` | Clone the organization source repository. |
169
+ | `eigenpal agents\|agent install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
170
+ | `eigenpal agents\|agent init [options] <name>` | Create a new source package scaffold. |
171
+ | `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 pull. |
172
+ | `eigenpal agents\|agent commit [options]` | Validate changed source packages and commit them. |
173
+ | `eigenpal agents\|agent save [options]` | Validate, commit if dirty, and push the current source branch. |
174
+ | `eigenpal agents\|agent push [options]` | Push the current organization source branch and tags. |
175
+ | `eigenpal agents\|agent upgrade [options]` | Upgrade the source repository schema in place. |
176
+ | `eigenpal agents\|agent doctor [options]` | Check organization source repository health. |
177
+ | `eigenpal agents\|agent status [options]` | Show source repo and package status. |
178
+ | `eigenpal agents\|agent deps [options]` | List package workspace dependencies. |
179
+ | `eigenpal agents\|agent clean [options]` | Require a clean source working tree. |
180
+ | `eigenpal agents\|agent show [options] <automation>` | Show Git-backed automation details. |
181
+ | `eigenpal agents\|agent versions [options] <package>` | List package release versions. |
182
+ | `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. |
183
+ | `eigenpal agents\|agent sync [options] [automation]` | Sync an automation from the latest Git source release. |
184
+
185
+ ### File
186
+
187
+ | Command | Description |
188
+ | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
189
+ | `eigenpal agents\|agent file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
190
+ | `eigenpal agents\|agent file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
191
+ | `eigenpal agents\|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>` | [removed] Git-backed agents — edit source in Git and run `eigenpal agents save`. |
192
+ | `eigenpal agents\|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
193
+
194
+ ### Secret
195
+
196
+ | Command | Description |
197
+ | ----------------------------------------------------------- | ---------------------------------------------------------------- |
198
+ | `eigenpal agents\|agent secret set [options] <name>` | Encrypt and set a secret value in secrets.enc.yaml. |
199
+ | `eigenpal agents\|agent secret unset [options] <name>` | Remove a secret from secrets.enc.yaml. |
200
+ | `eigenpal agents\|agent secret import [options] <env-file>` | Import KEY=value entries from an env file into secrets.enc.yaml. |
201
+
202
+ ### Dataset
203
+
204
+ | Command | Description |
205
+ | ---------------------------------------------------------------------- | -------------------------------------------------------------------------- |
206
+ | `eigenpal agents\|agent dataset list\|ls [options] <agent-id-or-slug>` | List dataset examples for an agent. |
207
+ | `eigenpal agents\|agent dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
208
+ | `eigenpal agents\|agent dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
209
+ | `eigenpal agents\|agent dataset validate [options] [path]` | Validate a local dataset directory against the agent input/output schemas. |
210
+
211
+ ### Runs
212
+
213
+ | Command | Description |
214
+ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
215
+ | `eigenpal agents\|agent runs list\|ls [options] <target>` | List runs for an agent target, e.g. agents.invoice-agent. |
216
+ | `eigenpal agents\|agent runs get [options] <run-id>` | Get one agent run. |
217
+ | `eigenpal agents\|agent runs rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
218
+ | `eigenpal agents\|agent runs pull [options] <run-id>` | Download run feedback, expected artifacts, files, and metadata. |
219
+ | `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. |
220
+ | `eigenpal agents\|agent runs artifacts\|artifact list\|ls [options] <run-id>` | List available run artifacts without downloading them. |
221
+ | `eigenpal agents\|agent runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
222
+ | `eigenpal agents\|agent runs feedback\|fb update [options] <run-id>` | Edit feedback state, rating, message, or expected JSON for a run. |
223
+ | `eigenpal agents\|agent runs feedback\|fb resolve [options] <run-id>` | Mark run feedback as resolved. |
224
+ | `eigenpal agents\|agent runs feedback\|fb clear [options] <run-id>` | Delete feedback, expected.json, and expected files for a run. |
225
+ | `eigenpal agents\|agent runs expected list\|ls [options] <run-id>` | List expected JSON and files attached to a run. |
226
+ | `eigenpal agents\|agent runs expected pull [options] <run-id>` | Download expected JSON and files attached to a run. |
227
+ | `eigenpal agents\|agent runs expected upload [options] <run-id> <file>` | Upload a local file as an expected artifact. |
228
+ | `eigenpal agents\|agent runs expected copy-output [options] <run-id> <output-file>` | Copy a generated output file into expected artifacts. |
229
+ | `eigenpal agents\|agent runs expected rename [options] <run-id> <old-name> <new-name>` | Rename an expected artifact. |
230
+ | `eigenpal agents\|agent runs expected delete [options] <run-id> <name>` | Delete an expected artifact. |
231
+ | `eigenpal agents\|agent runs watch [options] <run-id>` | Watch a run until it reaches a terminal status. |
232
+ | `eigenpal agents\|agent runs cancel [options] <run-id>` | Cancel an agent run. |
233
+
234
+ ### Experiment
235
+
236
+ | Command | Description |
237
+ | ------------------------------------------------------------------------------------------ | ----------------------------------------------- |
238
+ | `eigenpal agents\|agent experiment\|exp run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
239
+ | `eigenpal agents\|agent experiment\|exp status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
240
+ | `eigenpal agents\|agent experiment\|exp results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
241
+ | `eigenpal agents\|agent experiment\|exp list\|ls [options] <agent-id-or-slug>` | List experiments. |
242
+ | `eigenpal agents\|agent experiment\|exp compare\|diff [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
243
+ | `eigenpal agents\|agent experiment\|exp cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
244
+
245
+ ### Session
246
+
247
+ | Command | Description |
248
+ | ---------------------------------------------------------------------- | -------------------------------------- |
249
+ | `eigenpal agents\|agent session list\|ls [options] <agent-id-or-slug>` | List builder sessions for an agent. |
250
+ | `eigenpal agents\|agent session get [options] <session-id>` | Get a builder session and messages. |
251
+ | `eigenpal agents\|agent session start [options] <agent-id-or-slug>` | Start a builder session. |
252
+ | `eigenpal agents\|agent session message [options] <session-id>` | Append a message to a builder session. |
253
+ | `eigenpal agents\|agent session stop [options] <session-id>` | Stop a builder session. |
254
+
255
+ ### Env
256
+
257
+ | Command | Description |
258
+ | ---------------------------------------------------- | ----------------------------------------------- |
259
+ | `eigenpal agents\|agent env pull [options] [target]` | Decrypt source secrets and print shell exports. |
260
+
261
+ ### Secrets
262
+
263
+ | Command | Description |
264
+ | ---------------------------------------------------------- | ----------------------------------------------- |
265
+ | `eigenpal agents\|agent secrets export [options] [target]` | Decrypt source secrets and print shell exports. |
266
+
267
+ ## Details
268
+
269
+ ### `eigenpal agents|agent run [options] <target>`
270
+
271
+ Run an agent target, e.g. agents.invoice-agent@latest.
272
+
273
+ ### Arguments
274
+
275
+ | Name | Required | Variadic | Description |
276
+ | -------- | -------- | -------- | ----------- |
277
+ | `target` | yes | no | |
278
+
279
+ ### Options
280
+
281
+ | Flag | Required | Default | Description |
282
+ | ---------------------- | -------- | ------- | -------------------------------------------- |
283
+ | `--base-url <url>` | no | | Server base URL |
284
+ | `--json` | no | | Output the raw server response as JSON |
285
+ | `--input-json <json>` | no | | JSON input object |
286
+ | `--input-file <path>` | no | | Input file to upload as multipart form-data |
287
+ | `--example <name>` | no | | Run a persisted dataset example by name |
288
+ | `--wait` | no | | Poll until the run reaches a terminal status |
289
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
290
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
291
+
292
+ ### `eigenpal agents|agent list|ls [options]`
293
+
294
+ List agents.
295
+
296
+ ### Options
297
+
298
+ | Flag | Required | Default | Description |
299
+ | ------------------ | -------- | ------- | -------------------------------------- |
300
+ | `--base-url <url>` | no | | Server base URL |
301
+ | `--limit <n>` | no | `50` | Page size |
302
+ | `--offset <n>` | no | `0` | Page offset |
303
+ | `--json` | no | | Output the raw server response as JSON |
304
+ | `--search <q>` | no | | Search by slug, name, or description |
305
+
306
+ ### `eigenpal agents|agent validate [options] [dir]`
307
+
308
+ Validate a local agent package (layout, manifest, schemas, and Git source rules).
309
+
310
+ ### Arguments
311
+
312
+ | Name | Required | Variadic | Description |
313
+ | ----- | -------- | -------- | ----------- |
314
+ | `dir` | no | no | |
315
+
316
+ ### Options
317
+
318
+ | Flag | Required | Default | Description |
319
+ | -------- | -------- | ------- | -------------------------------------- |
320
+ | `--json` | no | | Output the raw server response as JSON |
321
+
322
+ ### `eigenpal agents|agent clone [options]`
323
+
324
+ Clone the organization source repository.
325
+
326
+ ### Options
327
+
328
+ | Flag | Required | Default | Description |
329
+ | ------------------ | -------- | ------- | ---------------- |
330
+ | `--base-url <url>` | no | | Server base URL |
331
+ | `--out <dir>` | no | | Output directory |
332
+
333
+ ### `eigenpal agents|agent install [options] [packageRef]`
334
+
335
+ Materialize a source package and its workspace dependencies.
336
+
337
+ ### Arguments
338
+
339
+ | Name | Required | Variadic | Description |
340
+ | ------------ | -------- | -------- | ----------- |
341
+ | `packageRef` | no | no | |
342
+
343
+ ### Options
344
+
345
+ | Flag | Required | Default | Description |
346
+ | -------------------- | -------- | ------- | -------------------------------------------- |
347
+ | `--base-url <url>` | no | | Server base URL |
348
+ | `--out <dir>` | no | | Output directory for an explicit package ref |
349
+ | `--lockfile <path>` | no | | Lockfile path |
350
+ | `--frozen-lockfile` | no | | Install exactly from the existing lockfile |
351
+ | `--remote-url <url>` | no | | Use an explicit organization Git remote URL |
352
+
353
+ ### `eigenpal agents|agent init [options] <name>`
354
+
355
+ Create a new source package scaffold.
356
+
357
+ ### Arguments
358
+
359
+ | Name | Required | Variadic | Description |
360
+ | ------ | -------- | -------- | ----------- |
361
+ | `name` | yes | no | |
362
+
363
+ ### Options
364
+
365
+ | Flag | Required | Default | Description |
366
+ | ----------------------- | -------- | ------- | -------------------- |
367
+ | `--template <template>` | yes | | Package template |
368
+ | `--dir <dir>` | no | | Repository directory |
369
+
370
+ ### `eigenpal agents|agent pull [options]`
371
+
372
+ Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs pull.
373
+
374
+ ### Options
375
+
376
+ | Flag | Required | Default | Description |
377
+ | ------------------ | -------- | ------- | -------------------- |
378
+ | `--base-url <url>` | no | | Server base URL |
379
+ | `--dir <dir>` | no | | Repository directory |
380
+
381
+ ### `eigenpal agents|agent commit [options]`
382
+
383
+ Validate changed source packages and commit them.
384
+
385
+ ### Options
386
+
387
+ | Flag | Required | Default | Description |
388
+ | ------------------------- | -------- | ------- | -------------------- |
389
+ | `--base-url <url>` | no | | Server base URL |
390
+ | `-m, --message <message>` | yes | | Commit message |
391
+ | `--dir <dir>` | no | | Repository directory |
392
+
393
+ ### `eigenpal agents|agent save [options]`
394
+
395
+ Validate, commit if dirty, and push the current source branch.
396
+
397
+ ### Options
398
+
399
+ | Flag | Required | Default | Description |
400
+ | ------------------------- | -------- | ------- | -------------------------------------------- |
401
+ | `--base-url <url>` | no | | Server base URL |
402
+ | `-m, --message <message>` | no | | Commit message when source changes are dirty |
403
+ | `--dir <dir>` | no | | Repository directory |
404
+
405
+ ### `eigenpal agents|agent push [options]`
406
+
407
+ Push the current organization source branch and tags.
408
+
409
+ ### Options
410
+
411
+ | Flag | Required | Default | Description |
412
+ | ------------------ | -------- | ------- | -------------------- |
413
+ | `--base-url <url>` | no | | Server base URL |
414
+ | `--dir <dir>` | no | | Repository directory |
415
+
416
+ ### `eigenpal agents|agent upgrade [options]`
417
+
418
+ Upgrade the source repository schema in place.
419
+
420
+ ### Options
421
+
422
+ | Flag | Required | Default | Description |
423
+ | ------------- | -------- | ------- | -------------------------------------------- |
424
+ | `--dir <dir>` | no | | Repository directory |
425
+ | `--dry-run` | no | | Print upgrade actions without changing files |
426
+
427
+ ### `eigenpal agents|agent doctor [options]`
428
+
429
+ Check organization source repository health.
430
+
431
+ ### Options
432
+
433
+ | Flag | Required | Default | Description |
434
+ | ------------- | -------- | ------- | -------------------------------------- |
435
+ | `--json` | no | | Output the raw server response as JSON |
436
+ | `--dir <dir>` | no | | Directory to inspect |
437
+
438
+ ### `eigenpal agents|agent status [options]`
439
+
440
+ Show source repo and package status.
441
+
442
+ ### Options
443
+
444
+ | Flag | Required | Default | Description |
445
+ | ------------- | -------- | ------- | -------------------------------------- |
446
+ | `--json` | no | | Output the raw server response as JSON |
447
+ | `--dir <dir>` | no | | Directory to inspect |
448
+
449
+ ### `eigenpal agents|agent deps [options]`
450
+
451
+ List package workspace dependencies.
452
+
453
+ ### Options
454
+
455
+ | Flag | Required | Default | Description |
456
+ | ------------- | -------- | ------- | -------------------------------------- |
457
+ | `--json` | no | | Output the raw server response as JSON |
458
+ | `--dir <dir>` | no | | Directory to inspect |
459
+
460
+ ### `eigenpal agents|agent clean [options]`
461
+
462
+ Require a clean source working tree.
463
+
464
+ ### Options
465
+
466
+ | Flag | Required | Default | Description |
467
+ | ------------- | -------- | ------- | -------------------- |
468
+ | `--dir <dir>` | no | | Directory to inspect |
469
+
470
+ ### `eigenpal agents|agent show [options] <automation>`
471
+
472
+ Show Git-backed automation details.
473
+
474
+ ### Arguments
475
+
476
+ | Name | Required | Variadic | Description |
477
+ | ------------ | -------- | -------- | ----------- |
478
+ | `automation` | yes | no | |
479
+
480
+ ### Options
481
+
482
+ | Flag | Required | Default | Description |
483
+ | ------------------ | -------- | ------- | -------------------------------------- |
484
+ | `--base-url <url>` | no | | Server base URL |
485
+ | `--json` | no | | Output the raw server response as JSON |
486
+
487
+ ### `eigenpal agents|agent versions [options] <package>`
488
+
489
+ List package release versions.
490
+
491
+ ### Arguments
492
+
493
+ | Name | Required | Variadic | Description |
494
+ | --------- | -------- | -------- | ----------- |
495
+ | `package` | yes | no | |
496
+
497
+ ### Options
498
+
499
+ | Flag | Required | Default | Description |
500
+ | ------------------ | -------- | ------- | -------------------------------------- |
501
+ | `--base-url <url>` | no | | Server base URL |
502
+ | `--json` | no | | Output the raw server response as JSON |
503
+
504
+ ### `eigenpal agents|agent release [options] <version> [dir]`
505
+
506
+ Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead.
507
+
508
+ ### Arguments
509
+
510
+ | Name | Required | Variadic | Description |
511
+ | --------- | -------- | -------- | --------------------------------------------------- |
512
+ | `version` | yes | no | Version (X.Y.Z) or bump level (patch, minor, major) |
513
+ | `dir` | no | no | Package directory |
514
+
515
+ ### Options
516
+
517
+ | Flag | Required | Default | Description |
518
+ | ------------------------- | -------- | ------- | ------------------------------------------------------ |
519
+ | `--base-url <url>` | no | | Server base URL |
520
+ | `-m, --message <message>` | no | | Annotated tag message (default: Release <packagePath>) |
521
+
522
+ ### `eigenpal agents|agent sync [options] [automation]`
523
+
524
+ Sync an automation from the latest Git source release.
525
+
526
+ ### Arguments
527
+
528
+ | Name | Required | Variadic | Description |
529
+ | ------------ | -------- | -------- | ----------- |
530
+ | `automation` | no | no | |
531
+
532
+ ### Options
533
+
534
+ | Flag | Required | Default | Description |
535
+ | ------------------ | -------- | ------- | -------------------- |
536
+ | `--base-url <url>` | no | | Server base URL |
537
+ | `--dir <dir>` | no | | Directory to inspect |
538
+
539
+ ### `eigenpal agents|agent file list|ls [options] <agent-id-or-slug>`
540
+
541
+ List live files for an agent.
542
+
543
+ ### Arguments
544
+
545
+ | Name | Required | Variadic | Description |
546
+ | ------------------ | -------- | -------- | ----------- |
547
+ | `agent-id-or-slug` | yes | no | |
548
+
549
+ ### Options
550
+
551
+ | Flag | Required | Default | Description |
552
+ | ------------------ | -------- | ------- | ------------------------------------------ |
553
+ | `--base-url <url>` | no | | Server base URL |
554
+ | `--json` | no | | Output the raw server response as JSON |
555
+ | `--path <prefix>` | no | | Only list files beneath this relative path |
556
+
557
+ ### `eigenpal agents|agent file get [options] <agent-id-or-slug> <remote-path>`
558
+
559
+ Download one live agent file.
560
+
561
+ ### Arguments
562
+
563
+ | Name | Required | Variadic | Description |
564
+ | ------------------ | -------- | -------- | ----------- |
565
+ | `agent-id-or-slug` | yes | no | |
566
+ | `remote-path` | yes | no | |
567
+
568
+ ### Options
569
+
570
+ | Flag | Required | Default | Description |
571
+ | ------------------ | -------- | ------- | -------------------------------------- |
572
+ | `--base-url <url>` | no | | Server base URL |
573
+ | `--json` | no | | Output the raw server response as JSON |
574
+ | `--out <file>` | no | | Output file path |
575
+
576
+ ### `eigenpal agents|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`
577
+
578
+ [removed] Git-backed agents — edit source in Git and run `eigenpal agents save`.
579
+
580
+ ### Arguments
581
+
582
+ | Name | Required | Variadic | Description |
583
+ | ------------------ | -------- | -------- | ----------- |
584
+ | `agent-id-or-slug` | yes | no | |
585
+ | `remote-path` | yes | no | |
586
+ | `local-path` | yes | no | |
587
+
588
+ ### Options
589
+
590
+ | Flag | Required | Default | Description |
591
+ | ------------------ | -------- | ------- | -------------------------------------- |
592
+ | `--base-url <url>` | no | | Server base URL |
593
+ | `--json` | no | | Output the raw server response as JSON |
594
+
595
+ ### `eigenpal agents|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
596
+
597
+ Compare one live agent file against a local file.
598
+
599
+ ### Arguments
600
+
601
+ | Name | Required | Variadic | Description |
602
+ | ------------------ | -------- | -------- | ----------- |
603
+ | `agent-id-or-slug` | yes | no | |
604
+ | `remote-path` | yes | no | |
605
+ | `local-path` | yes | no | |
606
+
607
+ ### Options
608
+
609
+ | Flag | Required | Default | Description |
610
+ | ------------------ | -------- | ------- | -------------------------------------- |
611
+ | `--base-url <url>` | no | | Server base URL |
612
+ | `--json` | no | | Output the raw server response as JSON |
613
+
614
+ ### `eigenpal agents|agent secret set [options] <name>`
615
+
616
+ Encrypt and set a secret value in secrets.enc.yaml.
617
+
618
+ ### Arguments
619
+
620
+ | Name | Required | Variadic | Description |
621
+ | ------ | -------- | -------- | ----------- |
622
+ | `name` | yes | no | |
623
+
624
+ ### Options
625
+
626
+ | Flag | Required | Default | Description |
627
+ | ---------------------- | -------- | ------- | --------------------------------- |
628
+ | `--dir <dir>` | no | | Directory to inspect |
629
+ | `--stdin` | no | | Read the secret value from stdin |
630
+ | `--value-file <path>` | no | | Read the secret value from a file |
631
+ | `--description <text>` | no | | Secret description |
632
+
633
+ ### `eigenpal agents|agent secret unset [options] <name>`
634
+
635
+ Remove a secret from secrets.enc.yaml.
636
+
637
+ ### Arguments
638
+
639
+ | Name | Required | Variadic | Description |
640
+ | ------ | -------- | -------- | ----------- |
641
+ | `name` | yes | no | |
642
+
643
+ ### Options
644
+
645
+ | Flag | Required | Default | Description |
646
+ | ------------- | -------- | ------- | -------------------- |
647
+ | `--dir <dir>` | no | | Directory to inspect |
648
+
649
+ ### `eigenpal agents|agent secret import [options] <env-file>`
650
+
651
+ Import KEY=value entries from an env file into secrets.enc.yaml.
652
+
653
+ ### Arguments
654
+
655
+ | Name | Required | Variadic | Description |
656
+ | ---------- | -------- | -------- | ----------- |
657
+ | `env-file` | yes | no | |
658
+
659
+ ### Options
660
+
661
+ | Flag | Required | Default | Description |
662
+ | ------------- | -------- | ------- | -------------------- |
663
+ | `--dir <dir>` | no | | Directory to inspect |
664
+
665
+ ### `eigenpal agents|agent dataset list|ls [options] <agent-id-or-slug>`
666
+
667
+ List dataset examples for an agent.
668
+
669
+ ### Arguments
670
+
671
+ | Name | Required | Variadic | Description |
672
+ | ------------------ | -------- | -------- | ----------- |
673
+ | `agent-id-or-slug` | yes | no | |
674
+
675
+ ### Options
676
+
677
+ | Flag | Required | Default | Description |
678
+ | ------------------ | -------- | ------- | -------------------------------------- |
679
+ | `--base-url <url>` | no | | Server base URL |
680
+ | `--limit <n>` | no | `50` | Page size |
681
+ | `--offset <n>` | no | `0` | Page offset |
682
+ | `--json` | no | | Output the raw server response as JSON |
683
+
684
+ ### `eigenpal agents|agent dataset push [options] <agent-id-or-slug>`
685
+
686
+ Upload dataset examples from a local dataset directory.
687
+
688
+ ### Arguments
689
+
690
+ | Name | Required | Variadic | Description |
691
+ | ------------------ | -------- | -------- | ----------- |
692
+ | `agent-id-or-slug` | yes | no | |
693
+
694
+ ### Options
695
+
696
+ | Flag | Required | Default | Description |
697
+ | -------------------------- | -------- | ---------- | ---------------------------------------------------- |
698
+ | `--base-url <url>` | no | | Server base URL |
699
+ | `--json` | no | | Output the raw server response as JSON |
700
+ | `--file <path>` | yes | | Dataset directory |
701
+ | `--mode <append\|replace>` | no | `"append"` | Upload mode |
702
+ | `--yes` | no | | Confirm replace mode in non-interactive environments |
703
+
704
+ ### `eigenpal agents|agent dataset pull [options] <agent-id-or-slug>`
705
+
706
+ Download an agent dataset directory.
707
+
708
+ ### Arguments
709
+
710
+ | Name | Required | Variadic | Description |
711
+ | ------------------ | -------- | -------- | ----------- |
712
+ | `agent-id-or-slug` | yes | no | |
713
+
714
+ ### Options
715
+
716
+ | Flag | Required | Default | Description |
717
+ | ------------------ | -------- | ----------- | ---------------- |
718
+ | `--base-url <url>` | no | | Server base URL |
719
+ | `--out <dir>` | no | `"dataset"` | Output directory |
720
+
721
+ ### `eigenpal agents|agent dataset validate [options] [path]`
722
+
723
+ Validate a local dataset directory against the agent input/output schemas.
724
+
725
+ ### Arguments
726
+
727
+ | Name | Required | Variadic | Description |
728
+ | ------ | -------- | -------- | ----------- |
729
+ | `path` | no | no | |
730
+
731
+ ### Options
732
+
733
+ | Flag | Required | Default | Description |
734
+ | ------------------- | -------- | ------- | ------------------------------------------------------- |
735
+ | `--json` | no | | Output the raw server response as JSON |
736
+ | `--agent-dir <dir>` | no | `"."` | Agent package directory containing input/output schemas |
737
+
738
+ ### `eigenpal agents|agent runs list|ls [options] <target>`
739
+
740
+ List runs for an agent target, e.g. agents.invoice-agent.
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 rerun [options] <run-id>`
781
+
782
+ Create a new run from a previous run's stored input snapshot.
783
+
784
+ ### Arguments
785
+
786
+ | Name | Required | Variadic | Description |
787
+ | -------- | -------- | -------- | ----------- |
788
+ | `run-id` | yes | no | |
789
+
790
+ ### Options
791
+
792
+ | Flag | Required | Default | Description |
793
+ | ---------------------- | -------- | ------- | ---------------------------------------------- |
794
+ | `--base-url <url>` | no | | Server base URL |
795
+ | `--json` | no | | Output the raw server response as JSON |
796
+ | `--wait` | no | | Poll until the rerun reaches a terminal status |
797
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
798
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
799
+
800
+ ### `eigenpal agents|agent runs pull [options] <run-id>`
801
+
802
+ Download run feedback, expected artifacts, files, and metadata.
803
+
804
+ ### Arguments
805
+
806
+ | Name | Required | Variadic | Description |
807
+ | -------- | -------- | -------- | ----------- |
808
+ | `run-id` | yes | no | |
809
+
810
+ ### Options
811
+
812
+ | Flag | Required | Default | Description |
813
+ | ------------------- | -------- | --------------------- | ------------------------------------------------------------------------------------- |
814
+ | `--base-url <url>` | no | | Server base URL |
815
+ | `--out <dir>` | no | | Output directory |
816
+ | `--include <parts>` | no | `"feedback,expected"` | Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,all |
817
+ | `--json` | no | | Output a JSON summary of written artifacts |
818
+
819
+ ### `eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`
820
+
821
+ Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
822
+
823
+ ### Arguments
824
+
825
+ | Name | Required | Variadic | Description |
826
+ | ------------------ | -------- | -------- | ----------- |
827
+ | `reference-run-id` | yes | no | |
828
+ | `run-id` | yes | no | |
829
+
830
+ ### Options
831
+
832
+ | Flag | Required | Default | Description |
833
+ | ------------------- | -------- | ------- | ------------------------------------------------------------------- |
834
+ | `--base-url <url>` | no | | Server base URL |
835
+ | `--json` | no | | Output the raw server response as JSON |
836
+ | `--baseline` | no | | Compare actual outputs from both runs instead of expected artifacts |
837
+ | `--out <dir>` | no | | Write comparison artifacts to this directory |
838
+ | `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
839
+ | `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
840
+
841
+ ### `eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`
842
+
843
+ List available run artifacts without downloading them.
844
+
845
+ ### Arguments
846
+
847
+ | Name | Required | Variadic | Description |
848
+ | -------- | -------- | -------- | ----------- |
849
+ | `run-id` | yes | no | |
850
+
851
+ ### Options
852
+
853
+ | Flag | Required | Default | Description |
854
+ | ------------------ | -------- | ------- | -------------------------------------- |
855
+ | `--base-url <url>` | no | | Server base URL |
856
+ | `--json` | no | | Output the raw server response as JSON |
857
+
858
+ ### `eigenpal agents|agent runs trace [options] <run-id>`
859
+
860
+ Print raw trace.jsonl for a run, or write it with --out.
861
+
862
+ ### Arguments
863
+
864
+ | Name | Required | Variadic | Description |
865
+ | -------- | -------- | -------- | ----------- |
866
+ | `run-id` | yes | no | |
867
+
868
+ ### Options
869
+
870
+ | Flag | Required | Default | Description |
871
+ | ------------------ | -------- | ------- | ---------------- |
872
+ | `--base-url <url>` | no | | Server base URL |
873
+ | `--out <file>` | no | | Output file path |
874
+
875
+ ### `eigenpal agents|agent runs feedback|fb update [options] <run-id>`
876
+
877
+ Edit feedback state, rating, message, or expected JSON for a run.
878
+
879
+ ### Arguments
880
+
881
+ | Name | Required | Variadic | Description |
882
+ | -------- | -------- | -------- | ----------- |
883
+ | `run-id` | yes | no | |
884
+
885
+ ### Options
886
+
887
+ | Flag | Required | Default | Description |
888
+ | -------------------------------------- | -------- | ------- | ----------------------------------------- |
889
+ | `--base-url <url>` | no | | Server base URL |
890
+ | `--json` | no | | Output the raw server response as JSON |
891
+ | `--status <open\|resolved\|ignored>` | no | | Set feedback status |
892
+ | `--rating <pass\|fail\|partial\|none>` | no | | Set feedback rating |
893
+ | `--message <text>` | no | | Set feedback message body |
894
+ | `--message-file <path>` | no | | Read feedback message body from a file |
895
+ | `--expected-json <json>` | no | | Set structured expected JSON |
896
+ | `--expected-json-file <path>` | no | | Read structured expected JSON from a file |
897
+ | `--clear-message` | no | | Clear the feedback message body |
898
+ | `--clear-rating` | no | | Clear feedback rating |
899
+ | `--clear-expected-json` | no | | Delete structured expected JSON |
900
+
901
+ ### `eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`
902
+
903
+ Mark run feedback as resolved.
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
+ | `--message <text>` | no | | Set feedback message body |
918
+ | `--message-file <path>` | no | | Read feedback message body from a file |
919
+
920
+ ### `eigenpal agents|agent runs feedback|fb clear [options] <run-id>`
921
+
922
+ Delete feedback, expected.json, and expected files for a run.
923
+
924
+ ### Arguments
925
+
926
+ | Name | Required | Variadic | Description |
927
+ | -------- | -------- | -------- | ----------- |
928
+ | `run-id` | yes | no | |
929
+
930
+ ### Options
931
+
932
+ | Flag | Required | Default | Description |
933
+ | ------------------ | -------- | ------- | ---------------------------------------- |
934
+ | `--base-url <url>` | no | | Server base URL |
935
+ | `--json` | no | | Output the raw server response as JSON |
936
+ | `--yes` | no | | Required in non-interactive environments |
937
+
938
+ ### `eigenpal agents|agent runs expected list|ls [options] <run-id>`
939
+
940
+ List expected JSON and files attached to a run.
941
+
942
+ ### Arguments
943
+
944
+ | Name | Required | Variadic | Description |
945
+ | -------- | -------- | -------- | ----------- |
946
+ | `run-id` | yes | no | |
947
+
948
+ ### Options
949
+
950
+ | Flag | Required | Default | Description |
951
+ | ------------------ | -------- | ------- | -------------------------------------- |
952
+ | `--base-url <url>` | no | | Server base URL |
953
+ | `--json` | no | | Output the raw server response as JSON |
954
+
955
+ ### `eigenpal agents|agent runs expected pull [options] <run-id>`
956
+
957
+ Download expected JSON and files attached to a run.
958
+
959
+ ### Arguments
960
+
961
+ | Name | Required | Variadic | Description |
962
+ | -------- | -------- | -------- | ----------- |
963
+ | `run-id` | yes | no | |
964
+
965
+ ### Options
966
+
967
+ | Flag | Required | Default | Description |
968
+ | ------------------ | -------- | ------- | ---------------- |
969
+ | `--base-url <url>` | no | | Server base URL |
970
+ | `--out <dir>` | no | | Output directory |
971
+
972
+ ### `eigenpal agents|agent runs expected upload [options] <run-id> <file>`
973
+
974
+ Upload a local file as an expected artifact.
975
+
976
+ ### Arguments
977
+
978
+ | Name | Required | Variadic | Description |
979
+ | -------- | -------- | -------- | ----------- |
980
+ | `run-id` | yes | no | |
981
+ | `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 copy-output [options] <run-id> <output-file>`
992
+
993
+ Copy a generated output file into expected artifacts.
994
+
995
+ ### Arguments
996
+
997
+ | Name | Required | Variadic | Description |
998
+ | ------------- | -------- | -------- | ----------- |
999
+ | `run-id` | yes | no | |
1000
+ | `output-file` | yes | no | |
1001
+
1002
+ ### Options
1003
+
1004
+ | Flag | Required | Default | Description |
1005
+ | ------------------ | -------- | ------- | -------------------------------------- |
1006
+ | `--base-url <url>` | no | | Server base URL |
1007
+ | `--json` | no | | Output the raw server response as JSON |
1008
+ | `--name <name>` | no | | Expected artifact name |
1009
+
1010
+ ### `eigenpal agents|agent runs expected rename [options] <run-id> <old-name> <new-name>`
1011
+
1012
+ Rename an expected artifact.
1013
+
1014
+ ### Arguments
1015
+
1016
+ | Name | Required | Variadic | Description |
1017
+ | ---------- | -------- | -------- | ----------- |
1018
+ | `run-id` | yes | no | |
1019
+ | `old-name` | yes | no | |
1020
+ | `new-name` | yes | no | |
1021
+
1022
+ ### Options
1023
+
1024
+ | Flag | Required | Default | Description |
1025
+ | ------------------ | -------- | ------- | -------------------------------------- |
1026
+ | `--base-url <url>` | no | | Server base URL |
1027
+ | `--json` | no | | Output the raw server response as JSON |
1028
+
1029
+ ### `eigenpal agents|agent runs expected delete [options] <run-id> <name>`
1030
+
1031
+ Delete an expected artifact.
1032
+
1033
+ ### Arguments
1034
+
1035
+ | Name | Required | Variadic | Description |
1036
+ | -------- | -------- | -------- | ----------- |
1037
+ | `run-id` | yes | no | |
1038
+ | `name` | yes | no | |
1039
+
1040
+ ### Options
1041
+
1042
+ | Flag | Required | Default | Description |
1043
+ | ------------------ | -------- | ------- | ---------------------------------------- |
1044
+ | `--base-url <url>` | no | | Server base URL |
1045
+ | `--json` | no | | Output the raw server response as JSON |
1046
+ | `--yes` | no | | Required in non-interactive environments |
1047
+
1048
+ ### `eigenpal agents|agent runs watch [options] <run-id>`
1049
+
1050
+ Watch a run until it reaches a terminal status.
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
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
1065
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
1066
+
1067
+ ### `eigenpal agents|agent runs cancel [options] <run-id>`
1068
+
1069
+ Cancel an agent run.
1070
+
1071
+ ### Arguments
1072
+
1073
+ | Name | Required | Variadic | Description |
1074
+ | -------- | -------- | -------- | ----------- |
1075
+ | `run-id` | yes | no | |
1076
+
1077
+ ### Options
1078
+
1079
+ | Flag | Required | Default | Description |
1080
+ | ------------------ | -------- | ------- | ---------------------------------------- |
1081
+ | `--base-url <url>` | no | | Server base URL |
1082
+ | `--json` | no | | Output the raw server response as JSON |
1083
+ | `--yes` | no | | Required in non-interactive environments |
1084
+
1085
+ ### `eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`
1086
+
1087
+ Start an experiment over dataset examples.
1088
+
1089
+ ### Arguments
1090
+
1091
+ | Name | Required | Variadic | Description |
1092
+ | ------------------ | -------- | -------- | ----------- |
1093
+ | `agent-id-or-slug` | yes | no | |
1094
+
1095
+ ### Options
1096
+
1097
+ | Flag | Required | Default | Description |
1098
+ | ---------------------- | -------- | ------- | --------------------------------------------------- |
1099
+ | `--base-url <url>` | no | | Server base URL |
1100
+ | `--json` | no | | Output the raw server response as JSON |
1101
+ | `--example-id <id>` | no | | Run one dataset example |
1102
+ | `--wait` | no | | Poll until the experiment reaches a terminal status |
1103
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
1104
+
1105
+ ### `eigenpal agents|agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`
1106
+
1107
+ Get experiment status.
1108
+
1109
+ ### Arguments
1110
+
1111
+ | Name | Required | Variadic | Description |
1112
+ | ------------------ | -------- | -------- | ----------- |
1113
+ | `agent-id-or-slug` | yes | no | |
1114
+ | `batch-id` | yes | no | |
1115
+
1116
+ ### Options
1117
+
1118
+ | Flag | Required | Default | Description |
1119
+ | ---------------------- | -------- | ------- | -------------------------------------- |
1120
+ | `--base-url <url>` | no | | Server base URL |
1121
+ | `--json` | no | | Output the raw server response as JSON |
1122
+ | `--watch` | no | | Poll until complete |
1123
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
1124
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
1125
+ | `--include <parts>` | no | | Reserved for future detailed parts |
1126
+
1127
+ ### `eigenpal agents|agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`
1128
+
1129
+ Print experiment results as JSON or CSV.
1130
+
1131
+ ### Arguments
1132
+
1133
+ | Name | Required | Variadic | Description |
1134
+ | ------------------ | -------- | -------- | ----------- |
1135
+ | `agent-id-or-slug` | yes | no | |
1136
+ | `batch-id` | no | no | |
1137
+
1138
+ ### Options
1139
+
1140
+ | Flag | Required | Default | Description |
1141
+ | ---------------------- | -------- | ------- | -------------------- |
1142
+ | `--base-url <url>` | no | | Server base URL |
1143
+ | `--format <csv\|json>` | yes | | Output format |
1144
+ | `--out <path>` | no | | Write output to file |
1145
+
1146
+ ### `eigenpal agents|agent experiment|exp list|ls [options] <agent-id-or-slug>`
1147
+
1148
+ List experiments.
1149
+
1150
+ ### Arguments
1151
+
1152
+ | Name | Required | Variadic | Description |
1153
+ | ------------------ | -------- | -------- | ----------- |
1154
+ | `agent-id-or-slug` | yes | no | |
1155
+
1156
+ ### Options
1157
+
1158
+ | Flag | Required | Default | Description |
1159
+ | ------------------ | -------- | ------- | -------------------------------------- |
1160
+ | `--base-url <url>` | no | | Server base URL |
1161
+ | `--limit <n>` | no | `50` | Page size |
1162
+ | `--offset <n>` | no | `0` | Page offset |
1163
+ | `--json` | no | | Output the raw server response as JSON |
1164
+ | `--batch-id <id>` | no | | Filter to one batch id |
1165
+
1166
+ ### `eigenpal agents|agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`
1167
+
1168
+ Compare two experiment batches.
1169
+
1170
+ ### Arguments
1171
+
1172
+ | Name | Required | Variadic | Description |
1173
+ | ------------ | -------- | -------- | ----------- |
1174
+ | `batch-id-a` | yes | no | |
1175
+ | `batch-id-b` | yes | no | |
1176
+
1177
+ ### Options
1178
+
1179
+ | Flag | Required | Default | Description |
1180
+ | ---------------------------- | -------- | ------- | ------------------------------------------------------------- |
1181
+ | `--base-url <url>` | no | | Server base URL |
1182
+ | `--json` | no | | Output the raw server response as JSON |
1183
+ | `--sort <mode>` | no | | Accepted for compatibility; sorting happens client-side later |
1184
+ | `--regression-threshold <n>` | no | | Accepted for compatibility |
1185
+
1186
+ ### `eigenpal agents|agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`
1187
+
1188
+ Cancel every active execution in an experiment.
1189
+
1190
+ ### Arguments
1191
+
1192
+ | Name | Required | Variadic | Description |
1193
+ | ------------------ | -------- | -------- | ----------- |
1194
+ | `agent-id-or-slug` | yes | no | |
1195
+ | `batch-id` | yes | no | |
1196
+
1197
+ ### Options
1198
+
1199
+ | Flag | Required | Default | Description |
1200
+ | ------------------ | -------- | ------- | ---------------------------------------- |
1201
+ | `--base-url <url>` | no | | Server base URL |
1202
+ | `--json` | no | | Output the raw server response as JSON |
1203
+ | `--yes` | no | | Required in non-interactive environments |
1204
+
1205
+ ### `eigenpal agents|agent session list|ls [options] <agent-id-or-slug>`
1206
+
1207
+ List builder sessions for an agent.
1208
+
1209
+ ### Arguments
1210
+
1211
+ | Name | Required | Variadic | Description |
1212
+ | ------------------ | -------- | -------- | ----------- |
1213
+ | `agent-id-or-slug` | yes | no | |
1214
+
1215
+ ### Options
1216
+
1217
+ | Flag | Required | Default | Description |
1218
+ | ------------------ | -------- | ------- | -------------------------------------- |
1219
+ | `--base-url <url>` | no | | Server base URL |
1220
+ | `--limit <n>` | no | `50` | Page size |
1221
+ | `--offset <n>` | no | `0` | Page offset |
1222
+ | `--json` | no | | Output the raw server response as JSON |
1223
+
1224
+ ### `eigenpal agents|agent session get [options] <session-id>`
1225
+
1226
+ Get a builder session and messages.
1227
+
1228
+ ### Arguments
1229
+
1230
+ | Name | Required | Variadic | Description |
1231
+ | ------------ | -------- | -------- | ----------- |
1232
+ | `session-id` | yes | no | |
1233
+
1234
+ ### Options
1235
+
1236
+ | Flag | Required | Default | Description |
1237
+ | ------------------ | -------- | ------- | -------------------------------------- |
1238
+ | `--base-url <url>` | no | | Server base URL |
1239
+ | `--json` | no | | Output the raw server response as JSON |
1240
+
1241
+ ### `eigenpal agents|agent session start [options] <agent-id-or-slug>`
1242
+
1243
+ Start a builder session.
1244
+
1245
+ ### Arguments
1246
+
1247
+ | Name | Required | Variadic | Description |
1248
+ | ------------------ | -------- | -------- | ----------- |
1249
+ | `agent-id-or-slug` | yes | no | |
1250
+
1251
+ ### Options
1252
+
1253
+ | Flag | Required | Default | Description |
1254
+ | ------------------ | -------- | ------- | -------------------------------------- |
1255
+ | `--base-url <url>` | no | | Server base URL |
1256
+ | `--json` | no | | Output the raw server response as JSON |
1257
+ | `--title <title>` | no | | Session title |
1258
+
1259
+ ### `eigenpal agents|agent session message [options] <session-id>`
1260
+
1261
+ Append a message to a builder session.
1262
+
1263
+ ### Arguments
1264
+
1265
+ | Name | Required | Variadic | Description |
1266
+ | ------------ | -------- | -------- | ----------- |
1267
+ | `session-id` | yes | no | |
1268
+
1269
+ ### Options
1270
+
1271
+ | Flag | Required | Default | Description |
1272
+ | ------------------ | -------- | ------- | ---------------------------------------------------------- |
1273
+ | `--base-url <url>` | no | | Server base URL |
1274
+ | `--json` | no | | Output the raw server response as JSON |
1275
+ | `--text <message>` | yes | | Message text |
1276
+ | `--wait` | no | | Reserved; server acknowledges after enqueueing the message |
1277
+
1278
+ ### `eigenpal agents|agent session stop [options] <session-id>`
1279
+
1280
+ Stop a builder session.
1281
+
1282
+ ### Arguments
1283
+
1284
+ | Name | Required | Variadic | Description |
1285
+ | ------------ | -------- | -------- | ----------- |
1286
+ | `session-id` | yes | no | |
1287
+
1288
+ ### Options
1289
+
1290
+ | Flag | Required | Default | Description |
1291
+ | ------------------ | -------- | ------- | ---------------------------------------- |
1292
+ | `--base-url <url>` | no | | Server base URL |
1293
+ | `--json` | no | | Output the raw server response as JSON |
1294
+ | `--yes` | no | | Required in non-interactive environments |
1295
+
1296
+ ### `eigenpal agents|agent env pull [options] [target]`
1297
+
1298
+ Decrypt source secrets and print shell exports.
1299
+
1300
+ ### Arguments
1301
+
1302
+ | Name | Required | Variadic | Description |
1303
+ | -------- | -------- | -------- | ----------- |
1304
+ | `target` | no | no | |
1305
+
1306
+ ### Options
1307
+
1308
+ | Flag | Required | Default | Description |
1309
+ | ------------------- | -------- | --------- | --------------------------------- |
1310
+ | `--base-url <url>` | no | | Server base URL |
1311
+ | `--dir <dir>` | no | `"."` | Installed agent package directory |
1312
+ | `--format <format>` | no | `"shell"` | Output format: shell or dotenv |
1313
+
1314
+ ### `eigenpal agents|agent secrets export [options] [target]`
1315
+
1316
+ Decrypt source secrets and print shell exports.
1317
+
1318
+ ### Arguments
1319
+
1320
+ | Name | Required | Variadic | Description |
1321
+ | -------- | -------- | -------- | ----------- |
1322
+ | `target` | no | no | |
1323
+
1324
+ ### Options
1325
+
1326
+ | Flag | Required | Default | Description |
1327
+ | ------------------- | -------- | --------- | --------------------------------- |
1328
+ | `--base-url <url>` | no | | Server base URL |
1329
+ | `--dir <dir>` | no | `"."` | Installed agent package directory |
1330
+ | `--format <format>` | no | `"shell"` | Output format: shell or dotenv |