@paigy/mcp 0.40.17 → 0.40.20

package/README.md

@@ -215,19 +215,48 @@ script and branch on `$PAIGY_EVENT` there:
 codex exec "Paigy goal $PAIGY_GOAL_ID. claim_goal it first. The user said: $PAIGY_TEXT. Reply with contact when done."
 ```
 
-## Stalled work (Claude Code stop hook)
+## Stalled work (turn-end hook — Claude Code, Codex, Gemini CLI, Antigravity)
 
 An agent that goes quiet leaves its Goals behind. Three things hand it that work back, all
 reading one rule (no progress for 3 days, `COLD_AFTER_MS`): `check_replies` lists it under
 `stalled`, `paigy-listen` carries it in `PAIGY_WORK` (and launches for it on boot), and this
-hook holds a Claude Code session's stop once a day to list it:
+hook holds a session's turn end once a day to list it. One program, four tools:
+
+**Claude Code** (`~/.claude/settings.json`) — installed by the paigy plugin:
 
 ```json
 { "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y -p @paigy/mcp paigy-stalled" }] }] } }
 ```
 
+**Codex** (`~/.codex/config.toml`) — its `Stop` event takes the same `{ decision, reason }`, so
+the same program serves it. Written for you when you pair from another tool:
+
+```toml
+[[hooks.Stop]]
+
+[[hooks.Stop.hooks]]
+type = "command"
+command = "npx -y -p @paigy/mcp@latest paigy-stalled --agent codex"
+timeout = 60
+```
+
+**Gemini CLI / Antigravity** (`~/.gemini/settings.json`, `~/.gemini/antigravity-cli/settings.json`)
+— the turn-end event there is `AfterAgent`, and the reminder also arrives as a `systemMessage`,
+which is the field that event promises will reach somebody:
+
+```json
+{ "hooks": { "AfterAgent": [{ "matcher": "*", "hooks": [{ "name": "paigy-stalled", "type": "command",
+  "command": "npx -y -p @paigy/mcp@latest paigy-stalled --agent antigravity", "timeout": 60000 }] }] } }
+```
+
+`--agent <slot>` is not optional outside Claude Code: a hook is not the MCP server, so it never
+inherits the `PAIGY_AGENT` that server was registered with, and without the flag it reads this
+session's own slot — a different identity, with no stalled work of its own. Pass the same value as
+the tool's MCP registration (`codex`, `antigravity`, or whatever you set `PAIGY_AGENT` to).
+
 It is silent when nothing is stalled, when the stop is already being continued by a hook, and
-after it has reminded that session once today.
+after it has reminded that session once today. Codex's older `notify` program is not a place for
+this: it is spawned fire-and-forget with stdio null, so nothing it prints can reach the agent.
 
 ## Statusline (Claude Code)