@hydra-acp/cli 0.1.40 → 0.1.42
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.
- package/README.md +35 -14
- package/dist/cli.js +528 -57
- package/dist/index.d.ts +14 -0
- package/dist/index.js +226 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -187,7 +187,7 @@ hydra-acp session
|
|
|
187
187
|
|
|
188
188
|
# 6. Attach a second client to an existing session.
|
|
189
189
|
# Bare invocation auto-detects: TUI in a terminal, ACP shim when piped.
|
|
190
|
-
hydra-acp --session
|
|
190
|
+
hydra-acp --session hydra_session_abc123
|
|
191
191
|
```
|
|
192
192
|
|
|
193
193
|
## CLI
|
|
@@ -198,34 +198,55 @@ hydra-acp shim # explicit shim mode (forces shim re
|
|
|
198
198
|
hydra-acp tui # explicit terminal-UI mode
|
|
199
199
|
hydra-acp launch <agent> # launcher mode: shim that forces the
|
|
200
200
|
# daemon to spawn <agent> on session/new
|
|
201
|
-
hydra-acp
|
|
201
|
+
hydra-acp cat [-p <prompt>] [--detach] # pipe-friendly headless mode: feeds stdin
|
|
202
|
+
# to a session as prompts and streams the
|
|
203
|
+
# agent's reply to stdout
|
|
204
|
+
hydra-acp --session <id-or-url> # attach to existing session
|
|
202
205
|
# (TUI in a TTY, shim otherwise)
|
|
206
|
+
hydra-acp --reattach # pick the most-recent session for cwd
|
|
207
|
+
hydra-acp --new # force a fresh session
|
|
208
|
+
hydra-acp --readonly # open a session as a transcript viewer (with --session)
|
|
203
209
|
|
|
204
210
|
hydra-acp init # generate the service token
|
|
211
|
+
|
|
212
|
+
hydra-acp daemon [status] # output status of daemon
|
|
205
213
|
hydra-acp daemon start [--foreground] # detached by default; --foreground to attach
|
|
206
|
-
hydra-acp daemon stop
|
|
207
|
-
hydra-acp daemon
|
|
214
|
+
hydra-acp daemon stop # stop running daemon
|
|
215
|
+
hydra-acp daemon restart # stop then start the daemon
|
|
216
|
+
hydra-acp daemon logs [-f] [-n N] # tail (default 50) or follow the daemon log
|
|
208
217
|
|
|
209
|
-
hydra-acp session
|
|
210
|
-
hydra-acp session kill <id>
|
|
211
|
-
hydra-acp session remove <id>
|
|
218
|
+
hydra-acp session [list ] # list sessions
|
|
219
|
+
hydra-acp session kill <id> # close a live session (keeps the on-disk record so it can be resurrected)
|
|
220
|
+
hydra-acp session remove <id> # remove a session entirely (live or cold)
|
|
212
221
|
hydra-acp session export <id> [--out <file>|.]
|
|
213
222
|
# write a session bundle (meta + history) to <file>,
|
|
214
223
|
# to a default-named file when --out=., or to stdout
|
|
215
|
-
hydra-acp session
|
|
224
|
+
hydra-acp session transcript <id>|<file> [--out <file>|.]
|
|
225
|
+
# render a session (id via daemon, or a local .hydra
|
|
226
|
+
# bundle) as a markdown transcript
|
|
227
|
+
hydra-acp session import <file>|- [--replace] [--cwd <path>] [--info]
|
|
216
228
|
# import a bundle from <file> or stdin (-);
|
|
217
|
-
# --replace overwrites
|
|
229
|
+
# --replace overwrites a lineage match (kills it
|
|
230
|
+
# if live); --cwd overrides the bundle's recorded
|
|
231
|
+
# working directory; --info prints the bundle's
|
|
232
|
+
# meta without importing
|
|
218
233
|
|
|
219
|
-
hydra-acp extension
|
|
234
|
+
hydra-acp extension [list] # list configured extensions and live state
|
|
220
235
|
hydra-acp extension add <name> # add to config (--command, --args, --env, --disabled)
|
|
221
236
|
hydra-acp extension remove <name> # remove from config
|
|
222
237
|
hydra-acp extension start|stop|restart <n> # lifecycle on a running extension
|
|
223
238
|
hydra-acp extension logs <name> [-f] [-n] # tail (default 50) or follow an extension's log
|
|
224
239
|
|
|
225
|
-
hydra-acp agent
|
|
240
|
+
hydra-acp agent [list] # list agents in the registry
|
|
226
241
|
hydra-acp agent install <id> # pre-install an agent (else lazy on first use)
|
|
242
|
+
hydra-acp agent refresh # force a registry re-fetch
|
|
243
|
+
hydra-acp agent sync <id> # spawn <id> just long enough to ACP session/list it,
|
|
244
|
+
# then persist any sessions it remembers as cold rows
|
|
245
|
+
# (lets you bring in pre-existing agent sessions)
|
|
227
246
|
|
|
228
|
-
hydra-acp
|
|
247
|
+
hydra-acp auth # list active session tokens
|
|
248
|
+
hydra-acp auth password [--force] # set the daemon's master password
|
|
249
|
+
hydra-acp auth revoke <id> # revoke a session token
|
|
229
250
|
```
|
|
230
251
|
|
|
231
252
|
A bare invocation (`hydra-acp` with no subcommand) auto-dispatches based on whether stdout is a TTY: a real terminal launches the TUI, a piped stdio (the editor-spawned case) drops into shim mode. Pass `shim` or `tui` explicitly to force one or the other. Editors should configure `hydra-acp shim` so the choice is unambiguous regardless of how the editor wires stdio.
|
|
@@ -317,11 +338,11 @@ Every config-knob flag has an `HYDRA_ACP_FOO_BAR` env-var equivalent. Flag wins
|
|
|
317
338
|
| `--name` | `HYDRA_ACP_NAME` |
|
|
318
339
|
| `--agent` | `HYDRA_ACP_AGENT` |
|
|
319
340
|
| `--model` | `HYDRA_ACP_MODEL` |
|
|
320
|
-
| `--session
|
|
341
|
+
| `--session` | `HYDRA_ACP_SESSION` |
|
|
321
342
|
|
|
322
343
|
`--model` is a one-shot override for the per-agent `defaultModels` entry in `~/.hydra-acp/config.json`. It only applies at fresh session creation — resurrect and `/hydra agent` switch ignore it (resurrected sessions stay on whatever model they were last using).
|
|
323
344
|
|
|
324
|
-
Action commands (`init`, `daemon`, `
|
|
345
|
+
Action commands (`init`, `daemon`, `session`, `extension`, `agent`, `auth`, `cat`, `--help`, `--version`, `--rotate-token`) are not config knobs and are flag-only.
|
|
325
346
|
|
|
326
347
|
### Registry id resolution
|
|
327
348
|
|