@paigy/mcp 0.16.0 → 0.17.1

package/README.md

@@ -112,6 +112,30 @@ Then pair: `npx -p @paigy/mcp@latest paigy-mcp-onboard`.
   ignored), and `paigy-listen`'s realtime wake channel is a websocket that doesn't
   proxy — its REST sweeps do.
 
+## Wake any harness (`paigy-listen`)
+
+`paigy-listen` is the self-hosted push daemon: it subscribes to this connection's
+wake channel and sweeps on every nudge. Keep it alive past the terminal with
+`paigy-listen --install` (launchd on macOS, systemd user unit on Linux; `--uninstall`
+removes it).
+
+To launch an agent — any agent, not just Claude — when work arrives, set
+`PAIGY_ON_WAKE` to a command before `--install`. The daemon runs it with the swept
+work in `$PAIGY_WORK` (JSON: `replies`, `requests`, `owedCallbacks`); the sweep has
+already claimed the work, so read `$PAIGY_WORK` rather than calling `check_replies`
+again. A request carrying a `contextThreadId` (or an unfamiliar `threadId`) means
+the user is resuming/seeding a past conversation — rehydrate with `get_thread` first.
+
+```sh
+# Claude Code:
+PAIGY_ON_WAKE='claude -p "Handle the Paigy work in $PAIGY_WORK — rehydrate threads you do not recognize via get_thread first."' \
+  npx -y -p @paigy/mcp paigy-listen --install
+
+# Codex (or any CLI harness) works the same way:
+PAIGY_ON_WAKE='codex exec "Handle the Paigy work in $PAIGY_WORK ..."' \
+  npx -y -p @paigy/mcp paigy-listen --install
+```
+
 ## Statusline (Claude Code)
 
 `paigy-statusline` prints a one-line connection status — the account's session
@@ -124,7 +148,7 @@ paigy: all calls · phone ✓
 Enable it in `~/.claude/settings.json`:
 
 ```json
-"statusLine": { "type": "command", "command": "npx -y @paigy/mcp@latest paigy-statusline" }
+"statusLine": { "type": "command", "command": "npx -y -p @paigy/mcp@latest paigy-statusline" }
 ```
 
 It reads `GET /api/status` with the pairing token and caches the result in

package/dist/{chunk-U3WODCOE.js → chunk-IMIXCPTN.js}

@@ -1,6 +1,6 @@
 import {
   AGENT_NAME
-} from "./chunk-R3YGSGPX.js";
+} from "./chunk-RMTTO6BI.js";
 
 // src/clients.ts
 import { execFile } from "child_process";