@akagilnc/pi-workflow-roles 0.1.2453 → 0.1.2456
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/package.json +1 -1
- package/resources/engines/hermes.md +62 -0
package/package.json
CHANGED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# hermes engine method material
|
|
2
|
+
|
|
3
|
+
This file is packaged technical material for the optional `hermes` labor
|
|
4
|
+
engine (Hermes Agent CLI on the host; current owner directive routes the
|
|
5
|
+
free-tier labor leg through it). Sourced from the official CLI reference
|
|
6
|
+
(hermes-agent.nousresearch.com/docs/reference/cli-commands, read 2026-08-28)
|
|
7
|
+
plus a live smoke on this host.
|
|
8
|
+
|
|
9
|
+
Before invoking the engine, read `../engine-dispatch.md`, resolving that path
|
|
10
|
+
relative to this note. This note only covers this engine's CLI technical
|
|
11
|
+
parameters.
|
|
12
|
+
|
|
13
|
+
## Invocation (official one-shot scripting mode)
|
|
14
|
+
|
|
15
|
+
The machine entrypoint is `hermes`. `-z` is the official pure-scripting mode:
|
|
16
|
+
"single prompt in, final response text out, nothing else on stdout or stderr"
|
|
17
|
+
— no banner, no spinner, no tool previews. Exit codes: `0` success,
|
|
18
|
+
`1` backend/delivery failure, `2` usage errors.
|
|
19
|
+
|
|
20
|
+
Factory labor line:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
hermes -z "YOUR_LABOR_PROMPT" --in /path/to/project --no-restore-cwd \
|
|
24
|
+
--ignore-rules --usage-file /tmp/hermes-usage.json
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
- `--in DIR` changes directory before start and scopes workspace lookups.
|
|
28
|
+
- `--no-restore-cwd` keeps the run from touching the interactive session's
|
|
29
|
+
working-directory state.
|
|
30
|
+
- `--ignore-rules` skips the host's personal AGENTS.md/SOUL.md/.cursorrules
|
|
31
|
+
and memory injection — required for factory legs so the owner's personal
|
|
32
|
+
agent identity does not leak into labor output.
|
|
33
|
+
- `--usage-file PATH` (works with `-z` only) writes a JSON spend report
|
|
34
|
+
(`estimated_cost_usd`, token counts, model, provider, `completed`/`failed`)
|
|
35
|
+
**even when the run fails** — attach it to the leg's receipt for accounting.
|
|
36
|
+
- Long or untrusted prompts: `--query-file PATH` reads the prompt from a file
|
|
37
|
+
verbatim ("nothing is shell-interpreted"); mutually exclusive with `-q`.
|
|
38
|
+
- Model/provider default comes from host `~/.hermes/config.yaml`
|
|
39
|
+
(owner-selected; verified 2026-08-28: `poolside/laguna-s-2.1:free` on Nous
|
|
40
|
+
Portal). Override with `-m provider/model` + `--provider` only when the
|
|
41
|
+
dispatch order says so.
|
|
42
|
+
- Isolation stronger than `--ignore-rules` exists but has trade-offs:
|
|
43
|
+
`--ignore-user-config` also drops the config-file model default and switches
|
|
44
|
+
credential loading to `.env`; `--safe-mode` additionally disables plugins,
|
|
45
|
+
hooks and MCP. Do not use them for routine labor unless the order says so —
|
|
46
|
+
they can sever the owner-configured model/auth path.
|
|
47
|
+
- Do NOT pass `--yolo` (blanket approval bypass) for factory labor;
|
|
48
|
+
permissions stay at the CLI's defaults.
|
|
49
|
+
- Debug variant: `hermes chat -q "..."` runs one-shot **with** tool output and
|
|
50
|
+
intermediate steps on stdout (unlike `-z`) — use when a labor run needs its
|
|
51
|
+
steps inspected.
|
|
52
|
+
|
|
53
|
+
## Smoke test (run before first labor leg of a session)
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
hermes -z "Reply with exactly one word: OK" --no-restore-cwd
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Expected: stdout is exactly `OK`, exit code 0. Verified 2026-08-28 on this
|
|
60
|
+
host (model `poolside/laguna-s-2.1:free`, Nous Portal). If it fails, check
|
|
61
|
+
`hermes status` (model/provider block) and `~/.hermes/provider_models_cache.json`
|
|
62
|
+
for the current catalog; the interactive picker is `hermes model`.
|