@trygocode/notify 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to `@trygocode/notify` are documented here. This project
 follows [Semantic Versioning](https://semver.org).
 
+## [0.1.2] — 2026-06-04
+
+### Fixed
+- **Hooks now work without a global install.** The Cursor `stop` hook and the
+  Claude Code `Stop`/`Notification`/`SubagentStop` hooks (and the Ralph/Homer
+  loop snippet) shelled out to a bare `gocode-notify send …`, which only
+  resolves when the package is installed globally on `PATH`. After an
+  `npx @trygocode/notify setup` (the documented flow) the binary was NOT on
+  `PATH`, so every hook silently failed (the `|| true` guard hid it) and no
+  phone notification was ever sent on agent completion. The hooks now invoke
+  `npx -y @trygocode/notify send …`, matching the MCP entry's invocation form,
+  so they work out of the box with zero global footprint. The idempotent
+  merge/uninstall markers were widened to `notify send` so they detect and
+  cleanly replace BOTH the new form and any legacy bare-command hook from an
+  older install.
+
 ## [0.1.1] — 2026-06-03
 
 ### Changed

package/README.md

@@ -180,9 +180,9 @@ completion/halt path:
 
 ```bash
 # At loop completion:
-gocode-notify send --kind loop_completed --source ralph --project "$(basename "$PWD")" || true
+npx -y @trygocode/notify send --kind loop_completed --source ralph --project "$(basename "$PWD")" || true
 # At loop halt (paused_max_failures / awaiting_human):
-gocode-notify send --kind loop_halted --source ralph --project "$(basename "$PWD")" \
+npx -y @trygocode/notify send --kind loop_halted --source ralph --project "$(basename "$PWD")" \
   --title "Ralph halted — needs you" || true
 ```
 

package/dist/src/claude.js

@@ -42,16 +42,20 @@ export const MCP_SERVER_ENTRY = {
  * (e.g. Cursor `stop` + Claude `Stop`) coalesce server-side.
  */
 export const CLAUDE_HOOK_COMMANDS = {
-    Stop: 'gocode-notify send --kind finished --source claude_code --dedupe-key "$CLAUDE_SESSION_ID-stop" || true',
-    Notification: 'gocode-notify send --kind awaiting_input --source claude_code --title "Agent needs you" --dedupe-key "$CLAUDE_SESSION_ID-notify" || true',
-    SubagentStop: 'gocode-notify send --kind finished --source claude_code --title "Subagent done" --dedupe-key "$CLAUDE_SESSION_ID-subagent" || true',
+    Stop: 'npx -y @trygocode/notify send --kind finished --source claude_code --dedupe-key "$CLAUDE_SESSION_ID-stop" || true',
+    Notification: 'npx -y @trygocode/notify send --kind awaiting_input --source claude_code --title "Agent needs you" --dedupe-key "$CLAUDE_SESSION_ID-notify" || true',
+    SubagentStop: 'npx -y @trygocode/notify send --kind finished --source claude_code --title "Subagent done" --dedupe-key "$CLAUDE_SESSION_ID-subagent" || true',
 };
 /**
  * Substrings that together identify a hook command as OURS. Used for idempotent
  * merge (replace, don't duplicate) and for surgical uninstall (remove exactly
  * ours). A command must contain BOTH to be considered ours.
+ *
+ * `notify send` matches BOTH the current `npx -y @trygocode/notify send …`
+ * form AND the legacy bare `gocode-notify send …` form, so upgrading from an
+ * older install is detected and cleanly replaced rather than duplicated.
  */
-const HOOK_MARKERS = ["gocode-notify", "--source claude_code"];
+const HOOK_MARKERS = ["notify send", "--source claude_code"];
 /**
  * The on-demand skill written to `~/.claude/skills/gocode-notify/SKILL.md`
  * (PRD §5.5). The crucial content is the anti-double-ping rule: the automatic

package/dist/src/cursor.js

@@ -41,13 +41,17 @@ export const MCP_SERVER_ENTRY = {
  * `--dedupe-key` so overlapping triggers (e.g. Cursor `stop` + Claude `Stop`)
  * coalesce server-side.
  */
-export const CURSOR_STOP_COMMAND = "gocode-notify send --kind finished --source cursor --dedupe-key cursor-stop || true";
+export const CURSOR_STOP_COMMAND = "npx -y @trygocode/notify send --kind finished --source cursor --dedupe-key cursor-stop || true";
 /**
  * Substrings that together identify a `stop` hook entry as OURS. Used for
  * idempotent merge (replace, don't duplicate) and for surgical uninstall (remove
  * exactly ours). A command must contain BOTH to be considered ours.
+ *
+ * `notify send` matches BOTH the current `npx -y @trygocode/notify send …`
+ * form AND the legacy bare `gocode-notify send …` form, so an upgrade from an
+ * older install is detected and cleanly replaced rather than duplicated.
  */
-const HOOK_MARKERS = ["gocode-notify", "--source cursor"];
+const HOOK_MARKERS = ["notify send", "--source cursor"];
 /**
  * The on-demand rule written to `~/.cursor/rules/gocode-notify.md` (PRD §5.5).
  * The crucial content is the anti-double-ping rule: the automatic pings are

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trygocode/notify",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Free phone notifications for any coding agent (Cursor, Claude Code, OpenCode, Ralph Wiggum / Autopilot loops) via the free GoCode app. One npx command installs the hooks + MCP server.",
   "license": "MIT",
   "type": "module",

package/snippets/ralph-homer.sh

@@ -14,8 +14,8 @@
 # can never block or fail your loop (the CLI also self-times-out in 5s).
 
 # --- At loop completion (the loop finished all work cleanly) -----------------
-gocode-notify send --kind loop_completed --source ralph --project "$(basename "$PWD")" || true
+npx -y @trygocode/notify send --kind loop_completed --source ralph --project "$(basename "$PWD")" || true
 
 # --- At loop halt (paused_max_failures / awaiting_human / question raised) ---
-gocode-notify send --kind loop_halted --source ralph --project "$(basename "$PWD")" \
+npx -y @trygocode/notify send --kind loop_halted --source ralph --project "$(basename "$PWD")" \
   --title "Ralph halted — needs you" || true