@eigenpal/cli 0.5.12 → 0.6.1

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.
@@ -1,1243 +0,0 @@
1
- # eigenpal agent
2
-
3
- Manage Eigenpal agents, triggers, datasets, executions, experiments, and sessions.
4
-
5
- ## Contents
6
-
7
- - [Surface](#surface)
8
- - [Commands](#commands)
9
- - [Core](#core)
10
- - [File](#file)
11
- - [Dataset](#dataset)
12
- - [Execution](#execution)
13
- - [Experiment](#experiment)
14
- - [Session](#session)
15
- - [Trigger](#trigger)
16
- - [Evaluators](#evaluators)
17
- - [Versions](#versions)
18
- - [Details](#details)
19
- - [`eigenpal agent list|ls [options]`](#eigenpal-agent-listls-options)
20
- - [`eigenpal agent push [options]`](#eigenpal-agent-push-options)
21
- - [`eigenpal agent pull [options] <agent-id-or-slug>`](#eigenpal-agent-pull-options-agent-id-or-slug)
22
- - [`eigenpal agent validate [options] [dir]`](#eigenpal-agent-validate-options-dir)
23
- - [`eigenpal agent file list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-file-listls-options-agent-id-or-slug)
24
- - [`eigenpal agent file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agent-file-get-options-agent-id-or-slug-remote-path)
25
- - [`eigenpal agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agent-file-put-options-agent-id-or-slug-remote-path-local-path)
26
- - [`eigenpal agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agent-file-diff-options-agent-id-or-slug-remote-path-local-path)
27
- - [`eigenpal agent dataset list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-listls-options-agent-id-or-slug)
28
- - [`eigenpal agent dataset push [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-push-options-agent-id-or-slug)
29
- - [`eigenpal agent dataset pull [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-pull-options-agent-id-or-slug)
30
- - [`eigenpal agent dataset validate [options] [path]`](#eigenpal-agent-dataset-validate-options-path)
31
- - [`eigenpal agent execution|exec run [options] <agent-id-or-slug>`](#eigenpal-agent-executionexec-run-options-agent-id-or-slug)
32
- - [`eigenpal agent execution|exec get [options] <execution-id>`](#eigenpal-agent-executionexec-get-options-execution-id)
33
- - [`eigenpal agent execution|exec rerun [options] <execution-id>`](#eigenpal-agent-executionexec-rerun-options-execution-id)
34
- - [`eigenpal agent execution|exec list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-executionexec-listls-options-agent-id-or-slug)
35
- - [`eigenpal agent execution|exec pull [options] <execution-id>`](#eigenpal-agent-executionexec-pull-options-execution-id)
36
- - [`eigenpal agent execution|exec compare|diff [options] <reference-execution-id> <execution-id>`](#eigenpal-agent-executionexec-comparediff-options-reference-execution-id-execution-id)
37
- - [`eigenpal agent execution|exec artifacts|artifact list|ls [options] <execution-id>`](#eigenpal-agent-executionexec-artifactsartifact-listls-options-execution-id)
38
- - [`eigenpal agent execution|exec trace [options] <execution-id>`](#eigenpal-agent-executionexec-trace-options-execution-id)
39
- - [`eigenpal agent execution|exec feedback|fb update [options] <execution-id>`](#eigenpal-agent-executionexec-feedbackfb-update-options-execution-id)
40
- - [`eigenpal agent execution|exec feedback|fb resolve [options] <execution-id>`](#eigenpal-agent-executionexec-feedbackfb-resolve-options-execution-id)
41
- - [`eigenpal agent execution|exec feedback|fb clear [options] <execution-id>`](#eigenpal-agent-executionexec-feedbackfb-clear-options-execution-id)
42
- - [`eigenpal agent execution|exec expected list|ls [options] <execution-id>`](#eigenpal-agent-executionexec-expected-listls-options-execution-id)
43
- - [`eigenpal agent execution|exec expected pull [options] <execution-id>`](#eigenpal-agent-executionexec-expected-pull-options-execution-id)
44
- - [`eigenpal agent execution|exec expected upload [options] <execution-id> <file>`](#eigenpal-agent-executionexec-expected-upload-options-execution-id-file)
45
- - [`eigenpal agent execution|exec expected copy-output [options] <execution-id> <output-file>`](#eigenpal-agent-executionexec-expected-copy-output-options-execution-id-output-file)
46
- - [`eigenpal agent execution|exec expected rename [options] <execution-id> <old-name> <new-name>`](#eigenpal-agent-executionexec-expected-rename-options-execution-id-old-name-new-name)
47
- - [`eigenpal agent execution|exec expected delete [options] <execution-id> <name>`](#eigenpal-agent-executionexec-expected-delete-options-execution-id-name)
48
- - [`eigenpal agent execution|exec watch [options] <execution-id>`](#eigenpal-agent-executionexec-watch-options-execution-id)
49
- - [`eigenpal agent execution|exec cancel [options] <execution-id>`](#eigenpal-agent-executionexec-cancel-options-execution-id)
50
- - [`eigenpal agent experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agent-experimentexp-run-options-agent-id-or-slug)
51
- - [`eigenpal agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agent-experimentexp-status-options-agent-id-or-slug-batch-id)
52
- - [`eigenpal agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agent-experimentexp-results-options-agent-id-or-slug-batch-id)
53
- - [`eigenpal agent experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-experimentexp-listls-options-agent-id-or-slug)
54
- - [`eigenpal agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`](#eigenpal-agent-experimentexp-comparediff-options-batch-id-a-batch-id-b)
55
- - [`eigenpal agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agent-experimentexp-cancel-options-agent-id-or-slug-batch-id)
56
- - [`eigenpal agent session list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-session-listls-options-agent-id-or-slug)
57
- - [`eigenpal agent session get [options] <session-id>`](#eigenpal-agent-session-get-options-session-id)
58
- - [`eigenpal agent session start [options] <agent-id-or-slug>`](#eigenpal-agent-session-start-options-agent-id-or-slug)
59
- - [`eigenpal agent session message [options] <session-id>`](#eigenpal-agent-session-message-options-session-id)
60
- - [`eigenpal agent session stop [options] <session-id>`](#eigenpal-agent-session-stop-options-session-id)
61
- - [`eigenpal agent trigger list|ls [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-listls-options-agent-id-or-slug)
62
- - [`eigenpal agent trigger api enable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-api-enable-options-agent-id-or-slug)
63
- - [`eigenpal agent trigger api disable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-api-disable-options-agent-id-or-slug)
64
- - [`eigenpal agent trigger email enable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-enable-options-agent-id-or-slug)
65
- - [`eigenpal agent trigger email disable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-disable-options-agent-id-or-slug)
66
- - [`eigenpal agent trigger email list|ls [options] [agent-id-or-slug]`](#eigenpal-agent-trigger-email-listls-options-agent-id-or-slug)
67
- - [`eigenpal agent trigger email add [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-add-options-agent-id-or-slug)
68
- - [`eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>`](#eigenpal-agent-trigger-email-update-options-agent-id-or-slug-email-id)
69
- - [`eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>`](#eigenpal-agent-trigger-email-remove-options-agent-id-or-slug-email-id)
70
- - [`eigenpal agent evaluators list|ls [options] [agent-id-or-slug]`](#eigenpal-agent-evaluators-listls-options-agent-id-or-slug)
71
- - [`eigenpal agent versions list|ls [options] [agent-id-or-slug]`](#eigenpal-agent-versions-listls-options-agent-id-or-slug)
72
-
73
- ## Surface
74
-
75
- ```
76
- agent
77
- ├── list|ls
78
- ├── push
79
- ├── pull <agent-id-or-slug>
80
- ├── file
81
- │ ├── list|ls <agent-id-or-slug>
82
- │ ├── get <agent-id-or-slug> <remote-path>
83
- │ ├── put <agent-id-or-slug> <remote-path> <local-path>
84
- │ └── diff <agent-id-or-slug> <remote-path> <local-path>
85
- ├── validate [dir]
86
- ├── dataset
87
- │ ├── list|ls <agent-id-or-slug>
88
- │ ├── push <agent-id-or-slug>
89
- │ ├── pull <agent-id-or-slug>
90
- │ └── validate [path]
91
- ├── execution|exec
92
- │ ├── run <agent-id-or-slug>
93
- │ ├── get <execution-id>
94
- │ ├── rerun <execution-id>
95
- │ ├── list|ls <agent-id-or-slug>
96
- │ ├── pull <execution-id>
97
- │ ├── compare|diff <reference-execution-id> <execution-id>
98
- │ ├── artifacts|artifact
99
- │ │ └── list|ls <execution-id>
100
- │ ├── trace <execution-id>
101
- │ ├── feedback|fb
102
- │ │ ├── update <execution-id>
103
- │ │ ├── resolve <execution-id>
104
- │ │ └── clear <execution-id>
105
- │ ├── expected
106
- │ │ ├── list|ls <execution-id>
107
- │ │ ├── pull <execution-id>
108
- │ │ ├── upload <execution-id> <file>
109
- │ │ ├── copy-output <execution-id> <output-file>
110
- │ │ ├── rename <execution-id> <old-name> <new-name>
111
- │ │ └── delete <execution-id> <name>
112
- │ ├── watch <execution-id>
113
- │ └── cancel <execution-id>
114
- ├── experiment|exp
115
- │ ├── run <agent-id-or-slug>
116
- │ ├── status <agent-id-or-slug> <batch-id>
117
- │ ├── results <agent-id-or-slug> [batch-id]
118
- │ ├── list|ls <agent-id-or-slug>
119
- │ ├── compare|diff <batch-id-a> <batch-id-b>
120
- │ └── cancel <agent-id-or-slug> <batch-id>
121
- ├── session
122
- │ ├── list|ls <agent-id-or-slug>
123
- │ ├── get <session-id>
124
- │ ├── start <agent-id-or-slug>
125
- │ ├── message <session-id>
126
- │ └── stop <session-id>
127
- ├── trigger
128
- │ ├── list|ls <agent-id-or-slug>
129
- │ ├── api
130
- │ │ ├── enable <agent-id-or-slug>
131
- │ │ └── disable <agent-id-or-slug>
132
- │ └── email
133
- │ ├── enable <agent-id-or-slug>
134
- │ ├── disable <agent-id-or-slug>
135
- │ ├── list|ls [agent-id-or-slug]
136
- │ ├── add <agent-id-or-slug>
137
- │ ├── update <agent-id-or-slug> <email-id>
138
- │ └── remove <agent-id-or-slug> <email-id>
139
- ├── evaluators
140
- │ └── list|ls [agent-id-or-slug]
141
- └── versions
142
- └── list|ls [agent-id-or-slug]
143
- ```
144
-
145
- ## Commands
146
-
147
- ### Core
148
-
149
- | Command | Description |
150
- | -------------------------------------------------- | ---------------------------------------------------------------- | ------------ |
151
- | `eigenpal agent list | ls [options]` | List agents. |
152
- | `eigenpal agent push [options]` | Create or update an agent from agent.yaml, agent/, and dataset/. |
153
- | `eigenpal agent pull [options] <agent-id-or-slug>` | Download an agent project as agent.yaml, agent/, and dataset/. |
154
- | `eigenpal agent validate [options] [dir]` | Validate a local agent project layout. |
155
-
156
- ### File
157
-
158
- | Command | Description |
159
- | ---------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------- |
160
- | `eigenpal agent file list | ls [options] <agent-id-or-slug>` | List live files for an agent. |
161
- | `eigenpal agent file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
162
- | `eigenpal agent file put [options] <agent-id-or-slug> <remote-path> <local-path>` | Upload one local file into the live agent namespace. |
163
- | `eigenpal agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
164
-
165
- ### Dataset
166
-
167
- | Command | Description |
168
- | ---------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------- |
169
- | `eigenpal agent dataset list | ls [options] <agent-id-or-slug>` | List dataset examples for an agent. |
170
- | `eigenpal agent dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
171
- | `eigenpal agent dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
172
- | `eigenpal agent dataset validate [options] [path]` | Validate a local dataset directory. |
173
-
174
- ### Execution
175
-
176
- | Command | Description |
177
- | ------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
178
- | `eigenpal agent execution | exec run [options] <agent-id-or-slug>` | Start one agent execution. |
179
- | `eigenpal agent execution | exec get [options] <execution-id>` | Get one agent execution. |
180
- | `eigenpal agent execution | exec rerun [options] <execution-id>` | Create a new execution from a previous execution's stored input snapshot. |
181
- | `eigenpal agent execution | exec list | ls [options] <agent-id-or-slug>` | List agent executions. |
182
- | `eigenpal agent execution | exec pull [options] <execution-id>` | Download execution feedback, expected artifacts, files, and metadata. |
183
- | `eigenpal agent execution | exec compare | diff [options] <reference-execution-id> <execution-id>` | Compare one execution against another execution. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks. |
184
- | `eigenpal agent execution | exec artifacts | artifact list | ls [options] <execution-id>` | List available execution artifacts without downloading them. |
185
- | `eigenpal agent execution | exec trace [options] <execution-id>` | Print raw trace.jsonl for an execution, or write it with --out. |
186
- | `eigenpal agent execution | exec feedback | fb update [options] <execution-id>` | Edit feedback state, rating, message, or expected JSON for an execution. |
187
- | `eigenpal agent execution | exec feedback | fb resolve [options] <execution-id>` | Mark execution feedback as resolved. |
188
- | `eigenpal agent execution | exec feedback | fb clear [options] <execution-id>` | Delete feedback, expected.json, and expected files for an execution. |
189
- | `eigenpal agent execution | exec expected list | ls [options] <execution-id>` | List expected JSON and files attached to an execution. |
190
- | `eigenpal agent execution | exec expected pull [options] <execution-id>` | Download expected JSON and files attached to an execution. |
191
- | `eigenpal agent execution | exec expected upload [options] <execution-id> <file>` | Upload a local file as an expected artifact. |
192
- | `eigenpal agent execution | exec expected copy-output [options] <execution-id> <output-file>` | Copy a generated output file into expected artifacts. |
193
- | `eigenpal agent execution | exec expected rename [options] <execution-id> <old-name> <new-name>` | Rename an expected artifact. |
194
- | `eigenpal agent execution | exec expected delete [options] <execution-id> <name>` | Delete an expected artifact. |
195
- | `eigenpal agent execution | exec watch [options] <execution-id>` | Watch an execution until it reaches a terminal status. |
196
- | `eigenpal agent execution | exec cancel [options] <execution-id>` | Cancel an agent execution. |
197
-
198
- ### Experiment
199
-
200
- | Command | Description |
201
- | -------------------------- | ---------------------------------------------------- | ----------------------------------------------- | ------------------------------- |
202
- | `eigenpal agent experiment | exp run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
203
- | `eigenpal agent experiment | exp status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
204
- | `eigenpal agent experiment | exp results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
205
- | `eigenpal agent experiment | exp list | ls [options] <agent-id-or-slug>` | List experiments. |
206
- | `eigenpal agent experiment | exp compare | diff [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
207
- | `eigenpal agent experiment | exp cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
208
-
209
- ### Session
210
-
211
- | Command | Description |
212
- | ----------------------------------------------------------- | -------------------------------------- | ----------------------------------- |
213
- | `eigenpal agent session list | ls [options] <agent-id-or-slug>` | List builder sessions for an agent. |
214
- | `eigenpal agent session get [options] <session-id>` | Get a builder session and messages. |
215
- | `eigenpal agent session start [options] <agent-id-or-slug>` | Start a builder session. |
216
- | `eigenpal agent session message [options] <session-id>` | Append a message to a builder session. |
217
- | `eigenpal agent session stop [options] <session-id>` | Stop a builder session. |
218
-
219
- ### Trigger
220
-
221
- | Command | Description |
222
- | ----------------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------ |
223
- | `eigenpal agent trigger list | ls [options] <agent-id-or-slug>` | List enabled agent triggers. |
224
- | `eigenpal agent trigger api enable [options] <agent-id-or-slug>` | Enable the API trigger for an agent. |
225
- | `eigenpal agent trigger api disable [options] <agent-id-or-slug>` | Disable the API trigger for an agent. |
226
- | `eigenpal agent trigger email enable [options] <agent-id-or-slug>` | Enable the email trigger for an agent. |
227
- | `eigenpal agent trigger email disable [options] <agent-id-or-slug>` | Disable the email trigger for an agent. |
228
- | `eigenpal agent trigger email list | ls [options] [agent-id-or-slug]` | List email triggers, optionally filtered to one agent. |
229
- | `eigenpal agent trigger email add [options] <agent-id-or-slug>` | Add an email trigger to an agent. |
230
- | `eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>` | Update an email trigger. |
231
- | `eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>` | Remove an email trigger. |
232
-
233
- ### Evaluators
234
-
235
- | Command | Description |
236
- | ------------------------------- | -------------------------------- | -------------------------------------------------------------------------------- |
237
- | `eigenpal agent evaluators list | ls [options] [agent-id-or-slug]` | Agent evaluators are reserved for future workflow-style evaluators. Coming soon. |
238
-
239
- ### Versions
240
-
241
- | Command | Description |
242
- | ----------------------------- | -------------------------------- | -------------------------------------------- |
243
- | `eigenpal agent versions list | ls [options] [agent-id-or-slug]` | Agent versions are coming soon. Coming soon. |
244
-
245
- ## Details
246
-
247
- ### `eigenpal agent list|ls [options]`
248
-
249
- List agents.
250
-
251
- ### Options
252
-
253
- | Flag | Required | Default | Description |
254
- | ------------------ | -------- | ------- | -------------------------------------- |
255
- | `--base-url <url>` | no | | Server base URL |
256
- | `--limit <n>` | no | `50` | Page size |
257
- | `--offset <n>` | no | `0` | Page offset |
258
- | `--json` | no | | Output the raw server response as JSON |
259
- | `--search <q>` | no | | Search by slug, name, or description |
260
-
261
- ### `eigenpal agent push [options]`
262
-
263
- Create or update an agent from agent.yaml, agent/, and dataset/.
264
-
265
- ### Options
266
-
267
- | Flag | Required | Default | Description |
268
- | ------------------------- | -------- | ------- | ------------------------------------------------ |
269
- | `--base-url <url>` | no | | Server base URL |
270
- | `--json` | no | | Output the raw server response as JSON |
271
- | `--dir <dir>` | no | `"."` | Agent project directory |
272
- | `--agent-id <id-or-slug>` | no | | Update an existing agent instead of creating one |
273
-
274
- ### `eigenpal agent pull [options] <agent-id-or-slug>`
275
-
276
- Download an agent project as agent.yaml, agent/, and dataset/.
277
-
278
- ### Arguments
279
-
280
- | Name | Required | Variadic | Description |
281
- | ------------------ | -------- | -------- | ----------- |
282
- | `agent-id-or-slug` | yes | no | |
283
-
284
- ### Options
285
-
286
- | Flag | Required | Default | Description |
287
- | ------------------ | -------- | ------- | ---------------- |
288
- | `--base-url <url>` | no | | Server base URL |
289
- | `--out <dir>` | no | | Output directory |
290
-
291
- ### `eigenpal agent validate [options] [dir]`
292
-
293
- Validate a local agent project layout.
294
-
295
- ### Arguments
296
-
297
- | Name | Required | Variadic | Description |
298
- | ----- | -------- | -------- | ----------- |
299
- | `dir` | no | no | |
300
-
301
- ### Options
302
-
303
- | Flag | Required | Default | Description |
304
- | -------- | -------- | ------- | -------------------------------------- |
305
- | `--json` | no | | Output the raw server response as JSON |
306
-
307
- ### `eigenpal agent file list|ls [options] <agent-id-or-slug>`
308
-
309
- List live files for an agent.
310
-
311
- ### Arguments
312
-
313
- | Name | Required | Variadic | Description |
314
- | ------------------ | -------- | -------- | ----------- |
315
- | `agent-id-or-slug` | yes | no | |
316
-
317
- ### Options
318
-
319
- | Flag | Required | Default | Description |
320
- | ------------------ | -------- | ------- | ------------------------------------------ |
321
- | `--base-url <url>` | no | | Server base URL |
322
- | `--json` | no | | Output the raw server response as JSON |
323
- | `--path <prefix>` | no | | Only list files beneath this relative path |
324
-
325
- ### `eigenpal agent file get [options] <agent-id-or-slug> <remote-path>`
326
-
327
- Download one live agent file.
328
-
329
- ### Arguments
330
-
331
- | Name | Required | Variadic | Description |
332
- | ------------------ | -------- | -------- | ----------- |
333
- | `agent-id-or-slug` | yes | no | |
334
- | `remote-path` | yes | no | |
335
-
336
- ### Options
337
-
338
- | Flag | Required | Default | Description |
339
- | ------------------ | -------- | ------- | -------------------------------------- |
340
- | `--base-url <url>` | no | | Server base URL |
341
- | `--json` | no | | Output the raw server response as JSON |
342
- | `--out <file>` | no | | Output file path |
343
-
344
- ### `eigenpal agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`
345
-
346
- Upload one local file into the live agent namespace.
347
-
348
- ### Arguments
349
-
350
- | Name | Required | Variadic | Description |
351
- | ------------------ | -------- | -------- | ----------- |
352
- | `agent-id-or-slug` | yes | no | |
353
- | `remote-path` | yes | no | |
354
- | `local-path` | yes | no | |
355
-
356
- ### Options
357
-
358
- | Flag | Required | Default | Description |
359
- | ------------------ | -------- | ------- | ----------------------------------------------------- |
360
- | `--base-url <url>` | no | | Server base URL |
361
- | `--json` | no | | Output the raw server response as JSON |
362
- | `--dry-run` | no | | Validate local file and remote path without uploading |
363
- | `--preview` | no | | Compare remote and local file without uploading |
364
-
365
- ### `eigenpal agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
366
-
367
- Compare one live agent file against a local file.
368
-
369
- ### Arguments
370
-
371
- | Name | Required | Variadic | Description |
372
- | ------------------ | -------- | -------- | ----------- |
373
- | `agent-id-or-slug` | yes | no | |
374
- | `remote-path` | yes | no | |
375
- | `local-path` | yes | no | |
376
-
377
- ### Options
378
-
379
- | Flag | Required | Default | Description |
380
- | ------------------ | -------- | ------- | -------------------------------------- |
381
- | `--base-url <url>` | no | | Server base URL |
382
- | `--json` | no | | Output the raw server response as JSON |
383
-
384
- ### `eigenpal agent dataset list|ls [options] <agent-id-or-slug>`
385
-
386
- List dataset examples for an agent.
387
-
388
- ### Arguments
389
-
390
- | Name | Required | Variadic | Description |
391
- | ------------------ | -------- | -------- | ----------- |
392
- | `agent-id-or-slug` | yes | no | |
393
-
394
- ### Options
395
-
396
- | Flag | Required | Default | Description |
397
- | ------------------ | -------- | ------- | -------------------------------------- |
398
- | `--base-url <url>` | no | | Server base URL |
399
- | `--limit <n>` | no | `50` | Page size |
400
- | `--offset <n>` | no | `0` | Page offset |
401
- | `--json` | no | | Output the raw server response as JSON |
402
-
403
- ### `eigenpal agent dataset push [options] <agent-id-or-slug>`
404
-
405
- Upload dataset examples from a local dataset directory.
406
-
407
- ### Arguments
408
-
409
- | Name | Required | Variadic | Description |
410
- | ------------------ | -------- | -------- | ----------- |
411
- | `agent-id-or-slug` | yes | no | |
412
-
413
- ### Options
414
-
415
- | Flag | Required | Default | Description |
416
- | -------------------------- | -------- | ---------- | ---------------------------------------------------- |
417
- | `--base-url <url>` | no | | Server base URL |
418
- | `--json` | no | | Output the raw server response as JSON |
419
- | `--file <path>` | yes | | Dataset directory |
420
- | `--mode <append\|replace>` | no | `"append"` | Upload mode |
421
- | `--yes` | no | | Confirm replace mode in non-interactive environments |
422
-
423
- ### `eigenpal agent dataset pull [options] <agent-id-or-slug>`
424
-
425
- Download an agent dataset directory.
426
-
427
- ### Arguments
428
-
429
- | Name | Required | Variadic | Description |
430
- | ------------------ | -------- | -------- | ----------- |
431
- | `agent-id-or-slug` | yes | no | |
432
-
433
- ### Options
434
-
435
- | Flag | Required | Default | Description |
436
- | ------------------ | -------- | ----------- | ---------------- |
437
- | `--base-url <url>` | no | | Server base URL |
438
- | `--out <dir>` | no | `"dataset"` | Output directory |
439
-
440
- ### `eigenpal agent dataset validate [options] [path]`
441
-
442
- Validate a local dataset directory.
443
-
444
- ### Arguments
445
-
446
- | Name | Required | Variadic | Description |
447
- | ------ | -------- | -------- | ----------- |
448
- | `path` | no | no | |
449
-
450
- ### Options
451
-
452
- | Flag | Required | Default | Description |
453
- | -------- | -------- | ------- | -------------------------------------- |
454
- | `--json` | no | | Output the raw server response as JSON |
455
-
456
- ### `eigenpal agent execution|exec run [options] <agent-id-or-slug>`
457
-
458
- Start one agent execution.
459
-
460
- ### Arguments
461
-
462
- | Name | Required | Variadic | Description |
463
- | ------------------ | -------- | -------- | ----------- |
464
- | `agent-id-or-slug` | yes | no | |
465
-
466
- ### Options
467
-
468
- | Flag | Required | Default | Description |
469
- | --------------------- | -------- | ------- | -------------------------------------------------- |
470
- | `--base-url <url>` | no | | Server base URL |
471
- | `--json` | no | | Output the raw server response as JSON |
472
- | `--input-json <json>` | no | | JSON input object |
473
- | `--input-file <path>` | no | | Input file to upload as multipart form-data |
474
- | `--wait` | no | | Poll until the execution reaches a terminal status |
475
-
476
- ### `eigenpal agent execution|exec get [options] <execution-id>`
477
-
478
- Get one agent execution.
479
-
480
- ### Arguments
481
-
482
- | Name | Required | Variadic | Description |
483
- | -------------- | -------- | -------- | ----------- |
484
- | `execution-id` | yes | no | |
485
-
486
- ### Options
487
-
488
- | Flag | Required | Default | Description |
489
- | ------------------- | -------- | ------------ | ----------------------------------------------------------------- |
490
- | `--base-url <url>` | no | | Server base URL |
491
- | `--json` | no | | Output the raw server response as JSON |
492
- | `--include <parts>` | no | `"feedback"` | Comma-separated extra parts: feedback,expected,files,trace,issues |
493
-
494
- ### `eigenpal agent execution|exec rerun [options] <execution-id>`
495
-
496
- Create a new execution from a previous execution's stored input snapshot.
497
-
498
- ### Arguments
499
-
500
- | Name | Required | Variadic | Description |
501
- | -------------- | -------- | -------- | ----------- |
502
- | `execution-id` | yes | no | |
503
-
504
- ### Options
505
-
506
- | Flag | Required | Default | Description |
507
- | ---------------------- | -------- | ------- | ---------------------------------------------- |
508
- | `--base-url <url>` | no | | Server base URL |
509
- | `--json` | no | | Output the raw server response as JSON |
510
- | `--wait` | no | | Poll until the rerun reaches a terminal status |
511
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
512
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
513
-
514
- ### `eigenpal agent execution|exec list|ls [options] <agent-id-or-slug>`
515
-
516
- List agent executions.
517
-
518
- ### Arguments
519
-
520
- | Name | Required | Variadic | Description |
521
- | ------------------ | -------- | -------- | ----------- |
522
- | `agent-id-or-slug` | yes | no | |
523
-
524
- ### Options
525
-
526
- | Flag | Required | Default | Description |
527
- | ----------------------------------------------- | -------- | ------- | ------------------------------------------------------------- |
528
- | `--base-url <url>` | no | | Server base URL |
529
- | `--limit <n>` | no | `50` | Page size |
530
- | `--offset <n>` | no | `0` | Page offset |
531
- | `--json` | no | | Output the raw server response as JSON |
532
- | `--status <status>` | no | | Filter by status |
533
- | `--batch-id <id>` | no | | Filter by experiment batch id |
534
- | `--example-name <name>` | no | | Filter by exact dataset example name |
535
- | `--example-name-contains <q>` | no | | Filter by substring in example name |
536
- | `--created-after <time>` | no | | Filter by created-at lower bound |
537
- | `--created-before <time>` | no | | Filter by created-at upper bound |
538
- | `--completed-after <time>` | no | | Filter by completed-at lower bound |
539
- | `--completed-before <time>` | no | | Filter by completed-at upper bound |
540
- | `--feedback-status <open\|resolved\|ignored>` | no | | Filter by feedback status |
541
- | `--feedback-rating <pass\|fail\|partial\|none>` | no | | Filter by feedback rating |
542
- | `--feedback-body-contains <q>` | no | | Filter by feedback body substring |
543
- | `--feedback-created-after <time>` | no | | Filter by feedback created-at lower bound |
544
- | `--feedback-created-before <time>` | no | | Filter by feedback created-at upper bound |
545
- | `--feedback-updated-after <time>` | no | | Filter by feedback updated-at lower bound |
546
- | `--feedback-updated-before <time>` | no | | Filter by feedback updated-at upper bound |
547
- | `--feedback-resolved-after <time>` | no | | Filter by feedback resolved-at lower bound |
548
- | `--feedback-resolved-before <time>` | no | | Filter by feedback resolved-at upper bound |
549
- | `--has-feedback` | no | | Only executions with feedback |
550
- | `--no-feedback` | no | | Only executions without feedback |
551
- | `--has-expected` | no | | Only executions with expected JSON or files |
552
- | `--has-expected-json` | no | | Only executions with expected.json |
553
- | `--has-expected-files` | no | | Only executions with expected files |
554
- | `--promoted-to-example` | no | | Only executions promoted to dataset examples |
555
- | `--promoted-example-name <name>` | no | | Filter by promoted dataset example name |
556
- | `--since-last-resolved` | no | | Only executions created after the latest resolved feedback |
557
- | `--include <parts>` | no | | Comma-separated extra parts: feedback,expected,files |
558
- | `--compact` | no | | Return/print compact triage rows without full output payloads |
559
- | `--sort <field>` | no | | Sort by createdAt, completedAt, status, or exampleName |
560
- | `--order <asc\|desc>` | no | | Sort direction |
561
- | `--scan-limit <n>` | no | | Feedback scan window for feedback filters |
562
-
563
- ### `eigenpal agent execution|exec pull [options] <execution-id>`
564
-
565
- Download execution feedback, expected artifacts, files, and metadata.
566
-
567
- ### Arguments
568
-
569
- | Name | Required | Variadic | Description |
570
- | -------------- | -------- | -------- | ----------- |
571
- | `execution-id` | yes | no | |
572
-
573
- ### Options
574
-
575
- | Flag | Required | Default | Description |
576
- | ------------------- | -------- | --------------------- | ------------------------------------------------------------------------------------- |
577
- | `--base-url <url>` | no | | Server base URL |
578
- | `--out <dir>` | no | | Output directory |
579
- | `--include <parts>` | no | `"feedback,expected"` | Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,all |
580
- | `--json` | no | | Output a JSON summary of written artifacts |
581
-
582
- ### `eigenpal agent execution|exec compare|diff [options] <reference-execution-id> <execution-id>`
583
-
584
- Compare one execution against another execution. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
585
-
586
- ### Arguments
587
-
588
- | Name | Required | Variadic | Description |
589
- | ------------------------ | -------- | -------- | ----------- |
590
- | `reference-execution-id` | yes | no | |
591
- | `execution-id` | yes | no | |
592
-
593
- ### Options
594
-
595
- | Flag | Required | Default | Description |
596
- | ------------------- | -------- | ------- | ------------------------------------------------------------------------- |
597
- | `--base-url <url>` | no | | Server base URL |
598
- | `--json` | no | | Output the raw server response as JSON |
599
- | `--baseline` | no | | Compare actual outputs from both executions instead of expected artifacts |
600
- | `--out <dir>` | no | | Write comparison artifacts to this directory |
601
- | `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
602
- | `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
603
-
604
- ### `eigenpal agent execution|exec artifacts|artifact list|ls [options] <execution-id>`
605
-
606
- List available execution artifacts without downloading them.
607
-
608
- ### Arguments
609
-
610
- | Name | Required | Variadic | Description |
611
- | -------------- | -------- | -------- | ----------- |
612
- | `execution-id` | yes | no | |
613
-
614
- ### Options
615
-
616
- | Flag | Required | Default | Description |
617
- | ------------------ | -------- | ------- | -------------------------------------- |
618
- | `--base-url <url>` | no | | Server base URL |
619
- | `--json` | no | | Output the raw server response as JSON |
620
-
621
- ### `eigenpal agent execution|exec trace [options] <execution-id>`
622
-
623
- Print raw trace.jsonl for an execution, or write it with --out.
624
-
625
- ### Arguments
626
-
627
- | Name | Required | Variadic | Description |
628
- | -------------- | -------- | -------- | ----------- |
629
- | `execution-id` | yes | no | |
630
-
631
- ### Options
632
-
633
- | Flag | Required | Default | Description |
634
- | ------------------ | -------- | ------- | ---------------- |
635
- | `--base-url <url>` | no | | Server base URL |
636
- | `--out <file>` | no | | Output file path |
637
-
638
- ### `eigenpal agent execution|exec feedback|fb update [options] <execution-id>`
639
-
640
- Edit feedback state, rating, message, or expected JSON for an execution.
641
-
642
- ### Arguments
643
-
644
- | Name | Required | Variadic | Description |
645
- | -------------- | -------- | -------- | ----------- |
646
- | `execution-id` | yes | no | |
647
-
648
- ### Options
649
-
650
- | Flag | Required | Default | Description |
651
- | -------------------------------------- | -------- | ------- | ----------------------------------------- |
652
- | `--base-url <url>` | no | | Server base URL |
653
- | `--json` | no | | Output the raw server response as JSON |
654
- | `--status <open\|resolved\|ignored>` | no | | Set feedback status |
655
- | `--rating <pass\|fail\|partial\|none>` | no | | Set feedback rating |
656
- | `--message <text>` | no | | Set feedback message body |
657
- | `--message-file <path>` | no | | Read feedback message body from a file |
658
- | `--expected-json <json>` | no | | Set structured expected JSON |
659
- | `--expected-json-file <path>` | no | | Read structured expected JSON from a file |
660
- | `--clear-message` | no | | Clear the feedback message body |
661
- | `--clear-rating` | no | | Clear feedback rating |
662
- | `--clear-expected-json` | no | | Delete structured expected JSON |
663
-
664
- ### `eigenpal agent execution|exec feedback|fb resolve [options] <execution-id>`
665
-
666
- Mark execution feedback as resolved.
667
-
668
- ### Arguments
669
-
670
- | Name | Required | Variadic | Description |
671
- | -------------- | -------- | -------- | ----------- |
672
- | `execution-id` | yes | no | |
673
-
674
- ### Options
675
-
676
- | Flag | Required | Default | Description |
677
- | ----------------------- | -------- | ------- | -------------------------------------- |
678
- | `--base-url <url>` | no | | Server base URL |
679
- | `--json` | no | | Output the raw server response as JSON |
680
- | `--message <text>` | no | | Set feedback message body |
681
- | `--message-file <path>` | no | | Read feedback message body from a file |
682
-
683
- ### `eigenpal agent execution|exec feedback|fb clear [options] <execution-id>`
684
-
685
- Delete feedback, expected.json, and expected files for an execution.
686
-
687
- ### Arguments
688
-
689
- | Name | Required | Variadic | Description |
690
- | -------------- | -------- | -------- | ----------- |
691
- | `execution-id` | yes | no | |
692
-
693
- ### Options
694
-
695
- | Flag | Required | Default | Description |
696
- | ------------------ | -------- | ------- | ---------------------------------------- |
697
- | `--base-url <url>` | no | | Server base URL |
698
- | `--json` | no | | Output the raw server response as JSON |
699
- | `--yes` | no | | Required in non-interactive environments |
700
-
701
- ### `eigenpal agent execution|exec expected list|ls [options] <execution-id>`
702
-
703
- List expected JSON and files attached to an execution.
704
-
705
- ### Arguments
706
-
707
- | Name | Required | Variadic | Description |
708
- | -------------- | -------- | -------- | ----------- |
709
- | `execution-id` | yes | no | |
710
-
711
- ### Options
712
-
713
- | Flag | Required | Default | Description |
714
- | ------------------ | -------- | ------- | -------------------------------------- |
715
- | `--base-url <url>` | no | | Server base URL |
716
- | `--json` | no | | Output the raw server response as JSON |
717
-
718
- ### `eigenpal agent execution|exec expected pull [options] <execution-id>`
719
-
720
- Download expected JSON and files attached to an execution.
721
-
722
- ### Arguments
723
-
724
- | Name | Required | Variadic | Description |
725
- | -------------- | -------- | -------- | ----------- |
726
- | `execution-id` | yes | no | |
727
-
728
- ### Options
729
-
730
- | Flag | Required | Default | Description |
731
- | ------------------ | -------- | ------- | ---------------- |
732
- | `--base-url <url>` | no | | Server base URL |
733
- | `--out <dir>` | no | | Output directory |
734
-
735
- ### `eigenpal agent execution|exec expected upload [options] <execution-id> <file>`
736
-
737
- Upload a local file as an expected artifact.
738
-
739
- ### Arguments
740
-
741
- | Name | Required | Variadic | Description |
742
- | -------------- | -------- | -------- | ----------- |
743
- | `execution-id` | yes | no | |
744
- | `file` | yes | no | |
745
-
746
- ### Options
747
-
748
- | Flag | Required | Default | Description |
749
- | ------------------ | -------- | ------- | -------------------------------------- |
750
- | `--base-url <url>` | no | | Server base URL |
751
- | `--json` | no | | Output the raw server response as JSON |
752
- | `--name <name>` | no | | Expected artifact name |
753
-
754
- ### `eigenpal agent execution|exec expected copy-output [options] <execution-id> <output-file>`
755
-
756
- Copy a generated output file into expected artifacts.
757
-
758
- ### Arguments
759
-
760
- | Name | Required | Variadic | Description |
761
- | -------------- | -------- | -------- | ----------- |
762
- | `execution-id` | yes | no | |
763
- | `output-file` | yes | no | |
764
-
765
- ### Options
766
-
767
- | Flag | Required | Default | Description |
768
- | ------------------ | -------- | ------- | -------------------------------------- |
769
- | `--base-url <url>` | no | | Server base URL |
770
- | `--json` | no | | Output the raw server response as JSON |
771
- | `--name <name>` | no | | Expected artifact name |
772
-
773
- ### `eigenpal agent execution|exec expected rename [options] <execution-id> <old-name> <new-name>`
774
-
775
- Rename an expected artifact.
776
-
777
- ### Arguments
778
-
779
- | Name | Required | Variadic | Description |
780
- | -------------- | -------- | -------- | ----------- |
781
- | `execution-id` | yes | no | |
782
- | `old-name` | yes | no | |
783
- | `new-name` | yes | no | |
784
-
785
- ### Options
786
-
787
- | Flag | Required | Default | Description |
788
- | ------------------ | -------- | ------- | -------------------------------------- |
789
- | `--base-url <url>` | no | | Server base URL |
790
- | `--json` | no | | Output the raw server response as JSON |
791
-
792
- ### `eigenpal agent execution|exec expected delete [options] <execution-id> <name>`
793
-
794
- Delete an expected artifact.
795
-
796
- ### Arguments
797
-
798
- | Name | Required | Variadic | Description |
799
- | -------------- | -------- | -------- | ----------- |
800
- | `execution-id` | yes | no | |
801
- | `name` | yes | no | |
802
-
803
- ### Options
804
-
805
- | Flag | Required | Default | Description |
806
- | ------------------ | -------- | ------- | ---------------------------------------- |
807
- | `--base-url <url>` | no | | Server base URL |
808
- | `--json` | no | | Output the raw server response as JSON |
809
- | `--yes` | no | | Required in non-interactive environments |
810
-
811
- ### `eigenpal agent execution|exec watch [options] <execution-id>`
812
-
813
- Watch an execution until it reaches a terminal status.
814
-
815
- ### Arguments
816
-
817
- | Name | Required | Variadic | Description |
818
- | -------------- | -------- | -------- | ----------- |
819
- | `execution-id` | yes | no | |
820
-
821
- ### Options
822
-
823
- | Flag | Required | Default | Description |
824
- | ---------------------- | -------- | ------- | -------------------------------------- |
825
- | `--base-url <url>` | no | | Server base URL |
826
- | `--json` | no | | Output the raw server response as JSON |
827
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
828
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
829
-
830
- ### `eigenpal agent execution|exec cancel [options] <execution-id>`
831
-
832
- Cancel an agent execution.
833
-
834
- ### Arguments
835
-
836
- | Name | Required | Variadic | Description |
837
- | -------------- | -------- | -------- | ----------- |
838
- | `execution-id` | yes | no | |
839
-
840
- ### Options
841
-
842
- | Flag | Required | Default | Description |
843
- | ------------------ | -------- | ------- | ---------------------------------------- |
844
- | `--base-url <url>` | no | | Server base URL |
845
- | `--json` | no | | Output the raw server response as JSON |
846
- | `--yes` | no | | Required in non-interactive environments |
847
-
848
- ### `eigenpal agent experiment|exp run [options] <agent-id-or-slug>`
849
-
850
- Start an experiment over dataset examples.
851
-
852
- ### Arguments
853
-
854
- | Name | Required | Variadic | Description |
855
- | ------------------ | -------- | -------- | ----------- |
856
- | `agent-id-or-slug` | yes | no | |
857
-
858
- ### Options
859
-
860
- | Flag | Required | Default | Description |
861
- | ---------------------- | -------- | ------- | --------------------------------------------------- |
862
- | `--base-url <url>` | no | | Server base URL |
863
- | `--json` | no | | Output the raw server response as JSON |
864
- | `--example-id <id>` | no | | Run one dataset example |
865
- | `--wait` | no | | Poll until the experiment reaches a terminal status |
866
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
867
-
868
- ### `eigenpal agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`
869
-
870
- Get experiment status.
871
-
872
- ### Arguments
873
-
874
- | Name | Required | Variadic | Description |
875
- | ------------------ | -------- | -------- | ----------- |
876
- | `agent-id-or-slug` | yes | no | |
877
- | `batch-id` | yes | no | |
878
-
879
- ### Options
880
-
881
- | Flag | Required | Default | Description |
882
- | ---------------------- | -------- | ------- | -------------------------------------- |
883
- | `--base-url <url>` | no | | Server base URL |
884
- | `--json` | no | | Output the raw server response as JSON |
885
- | `--watch` | no | | Poll until complete |
886
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
887
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
888
- | `--include <parts>` | no | | Reserved for future detailed parts |
889
-
890
- ### `eigenpal agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`
891
-
892
- Print experiment results as JSON or CSV.
893
-
894
- ### Arguments
895
-
896
- | Name | Required | Variadic | Description |
897
- | ------------------ | -------- | -------- | ----------- |
898
- | `agent-id-or-slug` | yes | no | |
899
- | `batch-id` | no | no | |
900
-
901
- ### Options
902
-
903
- | Flag | Required | Default | Description |
904
- | ---------------------- | -------- | ------- | -------------------- |
905
- | `--base-url <url>` | no | | Server base URL |
906
- | `--format <csv\|json>` | yes | | Output format |
907
- | `--out <path>` | no | | Write output to file |
908
-
909
- ### `eigenpal agent experiment|exp list|ls [options] <agent-id-or-slug>`
910
-
911
- List experiments.
912
-
913
- ### Arguments
914
-
915
- | Name | Required | Variadic | Description |
916
- | ------------------ | -------- | -------- | ----------- |
917
- | `agent-id-or-slug` | yes | no | |
918
-
919
- ### Options
920
-
921
- | Flag | Required | Default | Description |
922
- | ------------------ | -------- | ------- | -------------------------------------- |
923
- | `--base-url <url>` | no | | Server base URL |
924
- | `--limit <n>` | no | `50` | Page size |
925
- | `--offset <n>` | no | `0` | Page offset |
926
- | `--json` | no | | Output the raw server response as JSON |
927
- | `--batch-id <id>` | no | | Filter to one batch id |
928
-
929
- ### `eigenpal agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`
930
-
931
- Compare two experiment batches.
932
-
933
- ### Arguments
934
-
935
- | Name | Required | Variadic | Description |
936
- | ------------ | -------- | -------- | ----------- |
937
- | `batch-id-a` | yes | no | |
938
- | `batch-id-b` | yes | no | |
939
-
940
- ### Options
941
-
942
- | Flag | Required | Default | Description |
943
- | ---------------------------- | -------- | ------- | ------------------------------------------------------------- |
944
- | `--base-url <url>` | no | | Server base URL |
945
- | `--json` | no | | Output the raw server response as JSON |
946
- | `--sort <mode>` | no | | Accepted for compatibility; sorting happens client-side later |
947
- | `--regression-threshold <n>` | no | | Accepted for compatibility |
948
-
949
- ### `eigenpal agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`
950
-
951
- Cancel every active execution in an experiment.
952
-
953
- ### Arguments
954
-
955
- | Name | Required | Variadic | Description |
956
- | ------------------ | -------- | -------- | ----------- |
957
- | `agent-id-or-slug` | yes | no | |
958
- | `batch-id` | yes | no | |
959
-
960
- ### Options
961
-
962
- | Flag | Required | Default | Description |
963
- | ------------------ | -------- | ------- | ---------------------------------------- |
964
- | `--base-url <url>` | no | | Server base URL |
965
- | `--json` | no | | Output the raw server response as JSON |
966
- | `--yes` | no | | Required in non-interactive environments |
967
-
968
- ### `eigenpal agent session list|ls [options] <agent-id-or-slug>`
969
-
970
- List builder sessions for an agent.
971
-
972
- ### Arguments
973
-
974
- | Name | Required | Variadic | Description |
975
- | ------------------ | -------- | -------- | ----------- |
976
- | `agent-id-or-slug` | yes | no | |
977
-
978
- ### Options
979
-
980
- | Flag | Required | Default | Description |
981
- | ------------------ | -------- | ------- | -------------------------------------- |
982
- | `--base-url <url>` | no | | Server base URL |
983
- | `--limit <n>` | no | `50` | Page size |
984
- | `--offset <n>` | no | `0` | Page offset |
985
- | `--json` | no | | Output the raw server response as JSON |
986
-
987
- ### `eigenpal agent session get [options] <session-id>`
988
-
989
- Get a builder session and messages.
990
-
991
- ### Arguments
992
-
993
- | Name | Required | Variadic | Description |
994
- | ------------ | -------- | -------- | ----------- |
995
- | `session-id` | yes | no | |
996
-
997
- ### Options
998
-
999
- | Flag | Required | Default | Description |
1000
- | ------------------ | -------- | ------- | -------------------------------------- |
1001
- | `--base-url <url>` | no | | Server base URL |
1002
- | `--json` | no | | Output the raw server response as JSON |
1003
-
1004
- ### `eigenpal agent session start [options] <agent-id-or-slug>`
1005
-
1006
- Start a builder session.
1007
-
1008
- ### Arguments
1009
-
1010
- | Name | Required | Variadic | Description |
1011
- | ------------------ | -------- | -------- | ----------- |
1012
- | `agent-id-or-slug` | yes | no | |
1013
-
1014
- ### Options
1015
-
1016
- | Flag | Required | Default | Description |
1017
- | ------------------ | -------- | ------- | -------------------------------------- |
1018
- | `--base-url <url>` | no | | Server base URL |
1019
- | `--json` | no | | Output the raw server response as JSON |
1020
- | `--title <title>` | no | | Session title |
1021
-
1022
- ### `eigenpal agent session message [options] <session-id>`
1023
-
1024
- Append a message to a builder session.
1025
-
1026
- ### Arguments
1027
-
1028
- | Name | Required | Variadic | Description |
1029
- | ------------ | -------- | -------- | ----------- |
1030
- | `session-id` | yes | no | |
1031
-
1032
- ### Options
1033
-
1034
- | Flag | Required | Default | Description |
1035
- | ------------------ | -------- | ------- | ---------------------------------------------------------- |
1036
- | `--base-url <url>` | no | | Server base URL |
1037
- | `--json` | no | | Output the raw server response as JSON |
1038
- | `--text <message>` | yes | | Message text |
1039
- | `--wait` | no | | Reserved; server acknowledges after enqueueing the message |
1040
-
1041
- ### `eigenpal agent session stop [options] <session-id>`
1042
-
1043
- Stop a builder session.
1044
-
1045
- ### Arguments
1046
-
1047
- | Name | Required | Variadic | Description |
1048
- | ------------ | -------- | -------- | ----------- |
1049
- | `session-id` | yes | no | |
1050
-
1051
- ### Options
1052
-
1053
- | Flag | Required | Default | Description |
1054
- | ------------------ | -------- | ------- | ---------------------------------------- |
1055
- | `--base-url <url>` | no | | Server base URL |
1056
- | `--json` | no | | Output the raw server response as JSON |
1057
- | `--yes` | no | | Required in non-interactive environments |
1058
-
1059
- ### `eigenpal agent trigger list|ls [options] <agent-id-or-slug>`
1060
-
1061
- List enabled agent triggers.
1062
-
1063
- ### Arguments
1064
-
1065
- | Name | Required | Variadic | Description |
1066
- | ------------------ | -------- | -------- | ----------- |
1067
- | `agent-id-or-slug` | yes | no | |
1068
-
1069
- ### Options
1070
-
1071
- | Flag | Required | Default | Description |
1072
- | ------------------ | -------- | ------- | -------------------------------------- |
1073
- | `--base-url <url>` | no | | Server base URL |
1074
- | `--json` | no | | Output the raw server response as JSON |
1075
-
1076
- ### `eigenpal agent trigger api enable [options] <agent-id-or-slug>`
1077
-
1078
- Enable the API trigger for an agent.
1079
-
1080
- ### Arguments
1081
-
1082
- | Name | Required | Variadic | Description |
1083
- | ------------------ | -------- | -------- | ----------- |
1084
- | `agent-id-or-slug` | yes | no | |
1085
-
1086
- ### Options
1087
-
1088
- | Flag | Required | Default | Description |
1089
- | ------------------ | -------- | ------- | -------------------------------------- |
1090
- | `--base-url <url>` | no | | Server base URL |
1091
- | `--json` | no | | Output the raw server response as JSON |
1092
-
1093
- ### `eigenpal agent trigger api disable [options] <agent-id-or-slug>`
1094
-
1095
- Disable the API trigger for an agent.
1096
-
1097
- ### Arguments
1098
-
1099
- | Name | Required | Variadic | Description |
1100
- | ------------------ | -------- | -------- | ----------- |
1101
- | `agent-id-or-slug` | yes | no | |
1102
-
1103
- ### Options
1104
-
1105
- | Flag | Required | Default | Description |
1106
- | ------------------ | -------- | ------- | -------------------------------------- |
1107
- | `--base-url <url>` | no | | Server base URL |
1108
- | `--json` | no | | Output the raw server response as JSON |
1109
-
1110
- ### `eigenpal agent trigger email enable [options] <agent-id-or-slug>`
1111
-
1112
- Enable the email trigger for an agent.
1113
-
1114
- ### Arguments
1115
-
1116
- | Name | Required | Variadic | Description |
1117
- | ------------------ | -------- | -------- | ----------- |
1118
- | `agent-id-or-slug` | yes | no | |
1119
-
1120
- ### Options
1121
-
1122
- | Flag | Required | Default | Description |
1123
- | ------------------ | -------- | ------- | -------------------------------------- |
1124
- | `--base-url <url>` | no | | Server base URL |
1125
- | `--json` | no | | Output the raw server response as JSON |
1126
-
1127
- ### `eigenpal agent trigger email disable [options] <agent-id-or-slug>`
1128
-
1129
- Disable the email trigger for an agent.
1130
-
1131
- ### Arguments
1132
-
1133
- | Name | Required | Variadic | Description |
1134
- | ------------------ | -------- | -------- | ----------- |
1135
- | `agent-id-or-slug` | yes | no | |
1136
-
1137
- ### Options
1138
-
1139
- | Flag | Required | Default | Description |
1140
- | ------------------ | -------- | ------- | -------------------------------------- |
1141
- | `--base-url <url>` | no | | Server base URL |
1142
- | `--json` | no | | Output the raw server response as JSON |
1143
-
1144
- ### `eigenpal agent trigger email list|ls [options] [agent-id-or-slug]`
1145
-
1146
- List email triggers, optionally filtered to one agent.
1147
-
1148
- ### Arguments
1149
-
1150
- | Name | Required | Variadic | Description |
1151
- | ------------------ | -------- | -------- | ----------- |
1152
- | `agent-id-or-slug` | no | no | |
1153
-
1154
- ### Options
1155
-
1156
- | Flag | Required | Default | Description |
1157
- | ------------------ | -------- | ------- | -------------------------------------- |
1158
- | `--base-url <url>` | no | | Server base URL |
1159
- | `--json` | no | | Output the raw server response as JSON |
1160
-
1161
- ### `eigenpal agent trigger email add [options] <agent-id-or-slug>`
1162
-
1163
- Add an email trigger to an agent.
1164
-
1165
- ### Arguments
1166
-
1167
- | Name | Required | Variadic | Description |
1168
- | ------------------ | -------- | -------- | ----------- |
1169
- | `agent-id-or-slug` | yes | no | |
1170
-
1171
- ### Options
1172
-
1173
- | Flag | Required | Default | Description |
1174
- | ---------------------------- | -------- | ------- | -------------------------------------- |
1175
- | `--base-url <url>` | no | | Server base URL |
1176
- | `--json` | no | | Output the raw server response as JSON |
1177
- | `--email <local-part>` | yes | | Email local-part, e.g. invoice-intake |
1178
- | `--label <label>` | no | | Human label |
1179
- | `--allow <sender>` | no | `[]` | Allowed sender pattern; repeatable |
1180
- | `--reply <never\|always>` | no | | Reply behavior |
1181
- | `--reply-mode <sender\|all>` | no | | Reply recipients |
1182
-
1183
- ### `eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>`
1184
-
1185
- Update an email trigger.
1186
-
1187
- ### Arguments
1188
-
1189
- | Name | Required | Variadic | Description |
1190
- | ------------------ | -------- | -------- | ----------- |
1191
- | `agent-id-or-slug` | yes | no | |
1192
- | `email-id` | yes | no | |
1193
-
1194
- ### Options
1195
-
1196
- | Flag | Required | Default | Description |
1197
- | ----------------------------- | -------- | ------- | -------------------------------------- |
1198
- | `--base-url <url>` | no | | Server base URL |
1199
- | `--json` | no | | Output the raw server response as JSON |
1200
- | `--label <label>` | no | | Human label |
1201
- | `--allow <sender>` | no | `[]` | Allowed sender pattern; repeatable |
1202
- | `--status <active\|disabled>` | no | | Email trigger status |
1203
- | `--reply <never\|always>` | no | | Reply behavior |
1204
- | `--reply-mode <sender\|all>` | no | | Reply recipients |
1205
-
1206
- ### `eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>`
1207
-
1208
- Remove an email trigger.
1209
-
1210
- ### Arguments
1211
-
1212
- | Name | Required | Variadic | Description |
1213
- | ------------------ | -------- | -------- | ----------- |
1214
- | `agent-id-or-slug` | yes | no | |
1215
- | `email-id` | yes | no | |
1216
-
1217
- ### Options
1218
-
1219
- | Flag | Required | Default | Description |
1220
- | ------------------ | -------- | ------- | ---------------------------------------- |
1221
- | `--base-url <url>` | no | | Server base URL |
1222
- | `--json` | no | | Output the raw server response as JSON |
1223
- | `--yes` | no | | Required in non-interactive environments |
1224
-
1225
- ### `eigenpal agent evaluators list|ls [options] [agent-id-or-slug]`
1226
-
1227
- Agent evaluators are reserved for future workflow-style evaluators. Coming soon.
1228
-
1229
- ### Arguments
1230
-
1231
- | Name | Required | Variadic | Description |
1232
- | ------------------ | -------- | -------- | ----------- |
1233
- | `agent-id-or-slug` | no | no | |
1234
-
1235
- ### `eigenpal agent versions list|ls [options] [agent-id-or-slug]`
1236
-
1237
- Agent versions are coming soon. Coming soon.
1238
-
1239
- ### Arguments
1240
-
1241
- | Name | Required | Variadic | Description |
1242
- | ------------------ | -------- | -------- | ----------- |
1243
- | `agent-id-or-slug` | no | no | |