@trygocode/notify 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 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
+- **Real GoCode artwork** — replaced placeholder mark with the official GoCode
+  Notify icon (`icon-512.png` / `icon-128.png`) and a README hero banner. MCP
+  server `icons` metadata now points at the real PNGs.
+- **Clearer docs** — the free GoCode phone app is now called out up front as a
+  required component, the "free" status is stated explicitly, and a new
+  **GoCode platform settings** section documents auto-push, safe pull-before-push,
+  AI-Solve conflict resolution, and review-&-merge.
+- Renamed "Ralph / Homer loops" to "Ralph Wiggum / Autopilot script loops"
+  throughout for readers unfamiliar with the internal codenames.
+
 ## [0.1.0] — 2026-06-03
 
 Initial public release.
@@ -26,4 +55,5 @@ Initial public release.
 - **MCP server metadata** — `icons` + `websiteUrl` (SEP-973) so compatible clients
   can show the GoCode mark next to the server.
 
+[0.1.1]: https://github.com/joseph-lewis/gocode-notify/releases/tag/v0.1.1
 [0.1.0]: https://github.com/joseph-lewis/gocode-notify/releases/tag/v0.1.0

package/README.md

@@ -1,17 +1,18 @@
 <p align="center">
-  <img src="assets/icon.svg" alt="GoCode Notify" width="96" height="96" />
+  <img src="assets/icon-512.png" alt="GoCode Notify" width="104" height="104" />
 </p>
 
 <h1 align="center">@trygocode/notify</h1>
 
 <p align="center">
   <strong>Get a push notification on your phone the moment your AI coding agent finishes.</strong><br/>
-  Cursor · Claude Code · OpenCode · Ralph/Homer loops — installed with <em>one</em> command.
+  Cursor · Claude Code · OpenCode · Ralph Wiggum / Autopilot script loops — installed with <em>one</em> command.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@trygocode/notify"><img alt="npm" src="https://img.shields.io/npm/v/@trygocode/notify?color=5EE6A8&label=npm"></a>
   <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
+  <img alt="price" src="https://img.shields.io/badge/price-free-5EE6A8">
   <img alt="node" src="https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white">
   <img alt="works with" src="https://img.shields.io/badge/works%20with-Cursor%20%C2%B7%20Claude%20Code%20%C2%B7%20OpenCode-111">
 </p>
@@ -21,10 +22,16 @@ npx @trygocode/notify@latest setup
 ```
 
 <p align="center">
-  <!-- Joseph: drop a 2-3s screen recording of the phone notification arriving here. -->
-  <img src="assets/demo.gif" alt="A push notification arrives on the phone the instant the agent finishes" width="320" />
+  <img src="assets/banner.png" alt="GoCode Notify" width="640" />
 </p>
 
+> **Free.** `@trygocode/notify` and the **[GoCode](https://oh.jeltechsolutions.com)** phone app
+> that receives the pushes are both free to use.
+>
+> **You need the GoCode app.** Notifications are delivered to your phone through the free GoCode
+> app — it's the pairing target and the thing your phone buzzes with. Install it, pair once
+> (a 6-digit code), done. Without it there's nowhere for the pushes to land.
+
 ---
 
 ## Why?
@@ -38,6 +45,7 @@ you didn't notice.
 idle waiting for you, errors out, or an overnight loop completes/halts.** Walk
 away. Your phone tells you when it needs you.
 
+- 🆓 **Free.** The package and the GoCode phone app are free. No card, no trial.
 - ⚡ **One command.** `npx @trygocode/notify@latest setup` — no server to host, no config files to hand-edit.
 - 🔒 **Push-only & private.** The paired key can *only* send notifications to your phone. It can't read your chats, code, or settings. Revoke it any time.
 - 🧩 **Auto-detects your tools.** Wires up Cursor, Claude Code, and OpenCode in one go — never clobbering your existing hooks/MCP config.
@@ -50,17 +58,19 @@ away. Your phone tells you when it needs you.
 | **Cursor** | `stop` hook |
 | **Claude Code** | `Stop` + `Notification` + `SubagentStop` hooks |
 | **OpenCode** | runtime hook |
-| **Ralph / Homer loops** | opt-in completion/halt snippet |
+| **Ralph Wiggum / Autopilot script loops** | opt-in completion/halt snippet |
 
-> Notifications are delivered through the free **[GoCode](https://oh.jeltechsolutions.com)**
-> phone app (the one-time pairing target). Install GoCode, pair once, done.
+> **Requires the free [GoCode](https://oh.jeltechsolutions.com) phone app.** It's the one-time
+> pairing target and where every push lands. Install GoCode, pair once, done — both the app and
+> this package are free.
 
 ## Contents
 
 - [Install — two equally-supported paths](#install--two-equally-supported-paths)
 - [Pairing — step by step](#pairing--step-by-step)
 - [The three triggers](#the-three-triggers)
-- [Ralph/Homer opt-in snippet (trigger C)](#ralphhomer-opt-in-snippet-trigger-c)
+- [Loop opt-in snippet (trigger C)](#loop-opt-in-snippet-trigger-c)
+- [GoCode platform settings (auto-push, pull-before-push & more)](#gocode-platform-settings)
 - [Troubleshooting](#troubleshooting)
 - [Develop](#develop)
 - [Layout](#layout)
@@ -155,23 +165,24 @@ or staging GoCode server.
 |---|---|---|
 | **(A) Runtime hook** | Cursor `stop` / Claude Code `Stop`+`Notification`+`SubagentStop` | Agent finishes a turn, goes idle, or errors — **automatic, the killer feature** |
 | **(B) MCP tool** | `gocode_notify` tool the agent calls | You *explicitly* ask "ping me when X is done" mid-task |
-| **(C) Loop shell hook** | one line in your loop's completion/halt path | A Ralph/Homer loop reaches `completed` / `halted` |
+| **(C) Loop shell hook** | one line in your loop's completion/halt path | A Ralph Wiggum / Autopilot script loop reaches `completed` / `halted` |
 
 The installed rule/skill tells the agent **not** to call the MCP tool for
 done/idle/error pings — those are owned by the deterministic hook (A), so you
 never get double-pinged.
 
-## Ralph/Homer opt-in snippet (trigger C)
+## Loop opt-in snippet (trigger C)
 
-For power users running a loop **they control** (this repo's `ralph`/`homer`
-skills, a `while :; do … done` one-liner, or any custom driver), drop these two
-lines into the loop's completion/halt path:
+For power users running an autonomous loop **they control** — a *Ralph Wiggum*-style
+"keep prompting until done" loop, an Autopilot script, a `while :; do … done`
+one-liner, or any custom driver — drop these two lines into the loop's
+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
 ```
 
@@ -182,6 +193,24 @@ The ready-to-copy version with comments lives at
 loop scripts. Both lines are fire-and-forget (`|| true` + the CLI's 5s
 self-timeout), so a failed or slow push can never block or fail your loop.
 
+## GoCode platform settings
+
+This package is the *notifier*. The richer automation lives in the free **GoCode**
+phone app (Settings → per-project + global), which uses these notifications as its
+signalling layer. Once paired, the app gives you:
+
+| Setting | What it does |
+|---|---|
+| **Notification preferences** | Choose which events ping your phone — done / idle / error, loop completed, loop halted, agent questions, merge-ready — globally or per project. |
+| **Auto-push to git** | Opt-in: after a turn, the agent commits + pushes to a chosen branch so your work is never stranded on one machine and you can pick up anywhere. Off by default. |
+| **Pull-before-push (safe)** | When auto-push is on, a `git pull --rebase --autostash` runs first so remote changes merge cleanly. On a real conflict it aborts safely (nothing lost) and pings your phone. |
+| **AI-Solve conflicts** | If a push hits a conflict, the notification deep-links into the chat with two actions: **Acknowledge** or **AI-Solve** — your agent diagnoses local vs remote and resolves it with no code loss, asking you only when it's unsure. |
+| **Review & merge / Create PR** | When an Autopilot loop finishes on its own branch, you get a merge-ready ping; choose **Merge & push** (solo repos) or **Create PR** (teams), with a remembered default branch. |
+| **Default LLM & loop model** | Per-project defaults for the agent model and the Autopilot loop model. |
+
+> These toggles are configured **in the GoCode app**, not in this npm package — the
+> package just delivers the pings that drive them. All of it is free.
+
 ## Troubleshooting
 
 **Start here:** `gocode-notify status` prints a one-screen report — whether

package/assets/README.md

@@ -4,13 +4,10 @@ Brand assets for **GoCode Notify**.
 
 | File | Used by |
 |---|---|
-| `icon.svg` | MCP server icon metadata (`mimeType: image/svg+xml`, scalable), README, social. |
-| `icon-128.png` | MCP server icon metadata (`128x128`). |
-| `demo.gif` | README hero — the phone notification arriving when an agent finishes. |
-| `logo.png` | GitHub social preview / npm. |
+| `icon-512.png` | Primary GoCode Notify mark (512×512). README header + MCP server icon metadata. |
+| `icon-128.png` | MCP server icon metadata (128×128). |
+| `icon.svg` | Scalable fallback mark. |
+| `banner.png` | README hero banner (1280×320). |
 
-> **Joseph:** drop the real GoCode logo PNG/SVG and a 2-second demo GIF in here
-> (replace the placeholders). Keep filenames identical so the MCP icon URLs and
-> README image links keep resolving. Recommended: `icon.svg` (square, transparent),
-> `icon-128.png` (128×128), `demo.gif` (≤ 3s, ≤ 5 MB), `logo.png` (1280×640 for the
-> GitHub social card).
+All marks are the official GoCode logo. Keep filenames identical so the MCP icon
+URLs (served over GitHub's raw CDN) and README image links keep resolving.

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/dist/src/mcp.js

@@ -43,9 +43,9 @@ export const SERVER_ICONS = [
         sizes: ["128x128"],
     },
     {
-        src: "https://raw.githubusercontent.com/joseph-lewis/gocode-notify/main/assets/icon.svg",
-        mimeType: "image/svg+xml",
-        sizes: ["any"],
+        src: "https://raw.githubusercontent.com/joseph-lewis/gocode-notify/main/assets/icon-512.png",
+        mimeType: "image/png",
+        sizes: ["512x512"],
     },
 ];
 /** Tool name an agent calls to send an on-demand push. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trygocode/notify",
-  "version": "0.1.0",
-  "description": "Free phone notifications for any coding agent (Cursor, Claude Code, OpenCode, Ralph/Homer) via the GoCode app. One npx command installs the hooks + MCP server.",
+  "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",
   "homepage": "https://github.com/joseph-lewis/gocode-notify#readme",

package/snippets/ralph-homer.sh

@@ -1,4 +1,4 @@
-# gocode-notify — Ralph/Homer loop opt-in snippet  (PRD §5.6, trigger C)
+# gocode-notify — Ralph Wiggum / Autopilot script loop opt-in snippet  (trigger C)
 #
 # OPT-IN. This snippet is NOT auto-injected by `gocode-notify setup`; the
 # installer never edits your loop scripts without consent. Paste these two
@@ -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