nathangong 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,8 @@
 # nathangong
 
-Pops a macOS notification with a photo of **Nathan Gong** every time Claude Code
-finishes responding to a prompt. Download it and it just works.
+Pops a photo of **Nathan Gong** on screen every time Claude Code finishes
+responding to a prompt. Download it and it just works — no Rosetta, no
+Homebrew, no notification permissions.
 
 ## Install
 
@@ -10,27 +11,22 @@ npm install -g nathangong
 ```
 
 That's it. The `postinstall` step wires a Claude Code [`Stop` hook](https://docs.claude.com/en/docs/claude-code/hooks)
-into `~/.claude/settings.json`. The next time Claude finishes a turn, Nathan says hi.
+into `~/.claude/settings.json`. The next time Claude finishes a turn, Nathan's
+face fades in as a small card in the top-right of your screen, then fades out.
 
-### Photos vs. emoji
+Photos are drawn by a tiny bundled **native universal binary** (`vendor/nathan-popup`,
+built from `native/nathan-popup.swift`) — a borderless AppKit window. It never
+steals focus, adds no Dock icon, and runs on both Apple Silicon and Intel. If
+the binary can't launch for some reason, it falls back to a plain text
+notification via `osascript`.
 
-The photo is rendered via the bundled [`node-notifier`](https://github.com/mikaelbr/node-notifier),
-whose `terminal-notifier` binary is **x86_64**. So:
-
-- **Intel Mac**, or **Apple Silicon with Rosetta** → you get the **photo**. 📸
-- **Apple Silicon without Rosetta** → you get an **emoji notification** (macOS
-  can't attach a custom image without a runnable helper binary).
-
-To get photos on Apple Silicon, install Rosetta once:
-
-```bash
-softwareupdate --install-rosetta --agree-to-license
-```
+Tune how long the card stays up (default 2.5s) with an env var on the hook:
+`NATHANGONG_POPUP_SECONDS=4`.
 
 ## Commands
 
 ```bash
-nathangong test        # fire a notification right now to check it works
+nathangong test        # pop Nathan on screen right now to check it works
 nathangong install     # (re)wire the Stop hook
 nathangong uninstall   # remove the Stop hook
 ```
@@ -47,11 +43,17 @@ The `preuninstall` step removes the hook from your settings. (You can also run
 ## How it works
 
 - The `Stop` hook runs `node .../scripts/notify.js` when Claude ends a turn.
-- `notify.js` picks a random photo from `assets/` and fires a notification via
-  `node-notifier` (`contentImage`), falling back to `osascript` (emoji only).
+- `notify.js` picks a random photo from `assets/` and shows it with the native
+  `vendor/nathan-popup` window, falling back to an `osascript` text notification.
 - Editing `~/.claude/settings.json` is idempotent and backs the file up to
   `settings.json.nathangong.bak` before any change.
 
+## Rebuilding the native binary
+
+```bash
+bash native/build.sh   # needs Xcode; rebuilds vendor/nathan-popup (universal, ad-hoc signed)
+```
+
 ## Use as a library
 
 ```js

package/native/build.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Builds the universal (arm64 + x86_64) nathan-popup binary into ../vendor.
+# Requires Xcode / the Swift toolchain. Run on macOS.
+set -euo pipefail
+cd "$(dirname "$0")"
+
+SRC="nathan-popup.swift"
+OUT="../vendor/nathan-popup"
+mkdir -p ../vendor
+
+build() { # <arch>
+  swiftc -O -target "$1-apple-macos11" "$SRC" -o "nathan-popup-$1"
+}
+
+echo "building arm64…"
+build arm64
+SLICES=(nathan-popup-arm64)
+
+if build x86_64 2>/dev/null; then
+  echo "building x86_64… ok"
+  SLICES+=(nathan-popup-x86_64)
+else
+  echo "x86_64 slice failed — shipping arm64-only"
+fi
+
+lipo -create -output "$OUT" "${SLICES[@]}"
+rm -f nathan-popup-arm64 nathan-popup-x86_64
+chmod +x "$OUT"
+codesign -s - -f "$OUT"   # ad-hoc sign so Gatekeeper is happy
+echo "--- built $OUT ---"
+lipo -info "$OUT"
+codesign -dv "$OUT" 2>&1 | head -3

package/native/nathan-popup.swift

@@ -0,0 +1,100 @@
+// nathan-popup <imagePath> [caption] [seconds]
+//
+// Pops a small floating card showing an image (a photo of Nathan Gong) in the
+// top-right of the main screen, then fades out and exits. Deliberately avoids
+// Notification Center: no notification permission, no deprecated
+// NSUserNotification, no Rosetta — just an AppKit window. Works on any modern
+// macOS on both arm64 and x86_64.
+//
+// Non-activating + accessory policy => never steals focus, no Dock icon.
+
+import Cocoa
+
+let args = CommandLine.arguments
+guard args.count >= 2 else { exit(0) }
+let imagePath = args[1]
+let caption = args.count >= 3 ? args[2] : ""
+let seconds = args.count >= 4 ? (Double(args[3]) ?? 2.5) : 2.5
+
+guard let image = NSImage(contentsOfFile: imagePath) else { exit(0) }
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory) // no Dock icon, no focus steal
+
+// Layout
+let imgW: CGFloat = 240
+let ratio = image.size.width > 0 ? image.size.height / image.size.width : 1
+let imgH = (imgW * ratio).rounded()
+let capH: CGFloat = caption.isEmpty ? 0 : 24
+let pad: CGFloat = 12
+let winW = imgW + pad * 2
+let winH = imgH + capH + pad * 2
+
+guard let screen = NSScreen.main else { exit(0) }
+let vf = screen.visibleFrame
+let origin = NSPoint(x: vf.maxX - winW - 20, y: vf.maxY - winH - 20)
+
+let panel = NSPanel(
+    contentRect: NSRect(origin: origin, size: NSSize(width: winW, height: winH)),
+    styleMask: [.borderless, .nonactivatingPanel],
+    backing: .buffered,
+    defer: false
+)
+panel.isFloatingPanel = true
+panel.level = .floating
+panel.backgroundColor = .clear
+panel.isOpaque = false
+panel.hasShadow = true
+panel.ignoresMouseEvents = true
+panel.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary]
+
+let container = NSView(frame: NSRect(x: 0, y: 0, width: winW, height: winH))
+container.wantsLayer = true
+container.layer?.backgroundColor = NSColor(calibratedWhite: 0.10, alpha: 0.96).cgColor
+container.layer?.cornerRadius = 16
+
+let iv = NSImageView(frame: NSRect(x: pad, y: pad + capH, width: imgW, height: imgH))
+iv.image = image
+iv.imageScaling = .scaleProportionallyUpOrDown
+iv.wantsLayer = true
+iv.layer?.cornerRadius = 10
+iv.layer?.masksToBounds = true
+container.addSubview(iv)
+
+if !caption.isEmpty {
+    let label = NSTextField(labelWithString: caption)
+    label.frame = NSRect(x: pad, y: pad - 3, width: imgW, height: capH)
+    label.alignment = .center
+    label.textColor = .white
+    label.font = NSFont.systemFont(ofSize: 13, weight: .semibold)
+    label.backgroundColor = .clear
+    label.isBezeled = false
+    label.isEditable = false
+    label.lineBreakMode = .byTruncatingTail
+    container.addSubview(label)
+}
+
+panel.contentView = container
+panel.alphaValue = 0
+panel.orderFrontRegardless()
+
+NSAnimationContext.runAnimationGroup { ctx in
+    ctx.duration = 0.22
+    panel.animator().alphaValue = 1
+}
+
+DispatchQueue.main.asyncAfter(deadline: .now() + seconds) {
+    NSAnimationContext.runAnimationGroup({ ctx in
+        ctx.duration = 0.4
+        panel.animator().alphaValue = 0
+    }, completionHandler: {
+        app.terminate(nil)
+    })
+}
+
+// Safety valve: never linger forever.
+DispatchQueue.main.asyncAfter(deadline: .now() + seconds + 2) {
+    app.terminate(nil)
+}
+
+app.run()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nathangong",
-  "version": "0.1.0",
-  "description": "Pops a macOS notification with a photo of Nathan Gong after every Claude Code turn.",
+  "version": "0.2.0",
+  "description": "Pops a photo of Nathan Gong on screen after every Claude Code turn. Native, no Rosetta.",
   "keywords": [
     "nathan gong",
     "claude",
@@ -20,6 +20,8 @@
     "bin",
     "scripts",
     "assets",
+    "vendor",
+    "native",
     "index.js",
     "README.md"
   ],
@@ -30,8 +32,5 @@
   },
   "engines": {
     "node": ">=14"
-  },
-  "dependencies": {
-    "node-notifier": "^10.0.1"
   }
 }

package/scripts/notify.js

@@ -2,12 +2,10 @@
 "use strict";
 
 // The Claude Code `Stop` hook body: fires each time Claude finishes a turn.
-// Pops a macOS notification with a random photo of Nathan Gong.
-//
-// Uses node-notifier, which bundles its own copy of terminal-notifier and
-// supports `contentImage` — so the photo shows up with no extra system setup
-// (no Homebrew needed). Falls back to plain `osascript` (emoji only) if
-// node-notifier is unavailable or errors.
+// Pops a floating card with a random photo of Nathan Gong via our bundled
+// native `nathan-popup` binary (no notification permission, no Rosetta, works
+// on arm64 + x86_64). Falls back to a plain `osascript` text notification if
+// the binary is missing or can't launch.
 //
 // Rules: always exit 0 (a failing hook nags every turn) and never hang.
 
@@ -19,12 +17,12 @@ process.stdout.on("error", () => {});
 process.stderr.on("error", () => {});
 
 const TITLE = "nathan gong 🔔";
-const LINES = [
-  "nathan gong has entered the chat 🧑‍💻",
-  "a wild nathan gong appears 👋",
-  "nathan gong approves this prompt ✅",
-  "thinking about nathan gong 🤔",
-  "nathan gong says: nice turn 🏀",
+const CAPTIONS = [
+  "nathan gong 🧑‍💻",
+  "a wild nathan gong 👋",
+  "nathan approves ✅",
+  "thinking of nathan 🤔",
+  "nathan gong 🏀",
 ];
 
 function pick(arr) {
@@ -44,15 +42,20 @@ function pickImage() {
   }
 }
 
-function done() {
-  process.exit(0);
+function canRun(p) {
+  try {
+    fs.accessSync(p, fs.constants.X_OK);
+    return true;
+  } catch (_) {
+    return false;
+  }
 }
 
-// Emoji-only fallback — macOS's built-in notification can't render an image.
-function osascriptFallback(line) {
+// Emoji-only fallback — used only when the native popup can't run.
+function osascriptFallback(caption) {
   const script =
     "display notification " +
-    JSON.stringify(line) +
+    JSON.stringify(caption) +
     " with title " +
     JSON.stringify(TITLE);
   const child = spawn("osascript", ["-e", script], {
@@ -63,42 +66,27 @@ function osascriptFallback(line) {
 }
 
 function main() {
-  if (process.platform !== "darwin") return done();
+  if (process.platform !== "darwin") return process.exit(0);
 
-  const line = pick(LINES);
+  const caption = pick(CAPTIONS);
   const image = pickImage();
+  const popup = path.join(__dirname, "..", "vendor", "nathan-popup");
+  const seconds = String(Number(process.env.NATHANGONG_POPUP_SECONDS) || 2.5);
 
-  // Safety net: never let the hook hang the turn.
-  const safety = setTimeout(done, 5000);
-  safety.unref();
-
-  let notifier;
-  try {
-    notifier = require("node-notifier");
-  } catch (_) {
-    osascriptFallback(line);
-    return done();
+  if (image && canRun(popup)) {
+    const child = spawn(popup, [image, caption, seconds], {
+      detached: true,
+      stdio: "ignore",
+    });
+    child.on("error", () => osascriptFallback(caption));
+    child.unref();
+    // Linger briefly to catch a launch error, then always exit 0.
+    setTimeout(() => process.exit(0), 150);
+    return;
   }
 
-  try {
-    notifier.notify(
-      {
-        title: TITLE,
-        message: line,
-        contentImage: image || undefined, // right-side thumbnail (the photo)
-        appIcon: image || undefined, // left icon
-        sound: false,
-        wait: false,
-      },
-      (err) => {
-        if (err) osascriptFallback(line);
-        done();
-      }
-    );
-  } catch (_) {
-    osascriptFallback(line);
-    done();
-  }
+  osascriptFallback(caption);
+  process.exit(0);
 }
 
 main();

package/scripts/postinstall.js

@@ -28,23 +28,3 @@ try {
   log("nathangong: couldn't wire the hook automatically (" + (err && err.message) + ").");
   log("nathangong: run `nathangong install` to set it up manually.");
 }
-
-// Apple Silicon without Rosetta can't run the bundled x86_64 terminal-notifier,
-// so it falls back to an emoji notification. Let the user know how to get photos.
-try {
-  const os = require("os");
-  if (process.platform === "darwin" && os.arch() === "arm64") {
-    const { execFileSync } = require("child_process");
-    let rosetta = false;
-    try {
-      execFileSync("/usr/bin/pgrep", ["-q", "oahd"]);
-      rosetta = true;
-    } catch (_) {}
-    if (!rosetta) {
-      log("");
-      log("nathangong: you're on Apple Silicon without Rosetta — you'll get emoji");
-      log("nathangong: notifications. For actual PHOTOS of Nathan, install Rosetta once:");
-      log("   softwareupdate --install-rosetta --agree-to-license");
-    }
-  }
-} catch (_) {}