@paigy/harness 0.3.31 → 0.3.32

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 (4) hide show
  1. package/README.md +10 -4
  2. package/dist/cli.js +181 -110
  3. package/dist/main.js +113 -63
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -220,8 +220,14 @@ own `~/.paigy` slot:
220
220
 
221
221
  ```sh
222
222
  paigy-harness hatch "Voice bug hunter"
223
- PAIGY_AGENT="Voice bug hunter" claude # any tool speaks as it
224
- paigy-harness --identity "Voice bug hunter" --harness codex "fix the flaky test"
223
+ ```
224
+
225
+ To start a HELPER session, use `launch`, not hatch: it picks the helper's own session id, mints
226
+ the identity bound to it, places the brief as the helper's first Goal (under `--under GOAL`
227
+ when given), and starts the session on it — so every Paigy call the helper makes is its own:
228
+
229
+ ```sh
230
+ paigy-harness launch "Deploy check" --under <goalId> --harness claude "get CI green and merge"
225
231
  ```
226
232
 
227
233
  Hatched agents appear on the phone's Agents screen like any pairing — renameable,
@@ -269,8 +275,8 @@ It shows pairing, the party, the broker's card and queue, the doctor, the worksp
269
275
  allow-list, a Stop button, and the log.
270
276
 
271
277
  Headless flags: `--harness claude|codex`, `--mode bypass|ask`, `--cwd DIR`,
272
- `--identity NAME`, `--grace SECONDS`, `--doctor`; subcommands `host [--grant DIR]…`
273
- and `hatch NAME`. In ask mode the CLI is TERMINAL-FIRST: a blocked action or open
278
+ `--grace SECONDS`, `--doctor`; subcommands `host [--grant DIR]…`,
279
+ `hatch NAME` and `launch NAME [--under GOAL] BRIEF…`. In ask mode the CLI is TERMINAL-FIRST: a blocked action or open
274
280
  question prints in the terminal and waits `--grace` (default 90s); a person at the
275
281
  keyboard answers in place, an unattended terminal escalates to your phone (0 = phone
276
282
  immediately; non-TTY runs always go straight to the phone).