v0.3.3 — detect Ghostty inside tmux via GHOSTTY_RESOURCES_DIR fallback

Author: keefetang

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-alert",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "OS notifications for OpenCode — alerts when your agent needs attention",
   "type": "module",
   "main": "src/index.ts",

src/notify.ts

@@ -49,6 +49,9 @@ export function detectProtocol(): NotifyProtocol {
   } else if (env["TERM_PROGRAM"] === "iTerm.app" || env["ITERM_SESSION_ID"]) {
     cachedProtocol = "osc9";
   } else {
+    // Catch-all: osc777 covers Ghostty, WezTerm, foot, rxvt-unicode.
+    // This is correct even when TERM_PROGRAM=tmux (Ghostty inside tmux) —
+    // Ghostty uses osc777, so the fallback protocol matches by coincidence.
     cachedProtocol = "osc777";
   }
 

src/terminal.ts

@@ -60,6 +60,10 @@ export function detectTerminal(override?: string | null): TerminalInfo | null {
     if (termProgram.includes("hyper")) return TERMINALS["hyper"]!;
   }
 
+  // Ghostty sets GHOSTTY_RESOURCES_DIR even inside tmux (where TERM_PROGRAM
+  // gets overwritten to "tmux" after a server restart)
+  if (env["GHOSTTY_RESOURCES_DIR"]) return TERMINALS["ghostty"]!;
+
   // LC_TERMINAL (set by some terminals)
   const lcTerminal = env["LC_TERMINAL"]?.toLowerCase();
   if (lcTerminal) {

test/terminal.test.ts

@@ -8,6 +8,7 @@ import { detectTerminal } from "../src/terminal.js";
 
 const ENV_KEYS = [
   "TERM_PROGRAM",
+  "GHOSTTY_RESOURCES_DIR",
   "LC_TERMINAL",
   "KITTY_WINDOW_ID",
   "TERM",
@@ -124,6 +125,35 @@ describe("detectTerminal", () => {
     });
   });
 
+  // -- GHOSTTY_RESOURCES_DIR fallback (tmux case) -------------------------
+
+  describe("GHOSTTY_RESOURCES_DIR fallback", () => {
+    test("detects Ghostty when TERM_PROGRAM=tmux but GHOSTTY_RESOURCES_DIR is set", () => {
+      process.env["TERM_PROGRAM"] = "tmux";
+      process.env["GHOSTTY_RESOURCES_DIR"] = "/usr/share/ghostty";
+      const result = detectTerminal();
+      expect(result).not.toBeNull();
+      expect(result!.name).toBe("Ghostty");
+      expect(result!.protocol).toBe("osc777");
+    });
+
+    test("detects Ghostty via GHOSTTY_RESOURCES_DIR when no TERM_PROGRAM is set", () => {
+      process.env["GHOSTTY_RESOURCES_DIR"] = "/usr/share/ghostty";
+      const result = detectTerminal();
+      expect(result).not.toBeNull();
+      expect(result!.name).toBe("Ghostty");
+    });
+
+    test("TERM_PROGRAM=ghostty takes precedence over GHOSTTY_RESOURCES_DIR", () => {
+      process.env["TERM_PROGRAM"] = "ghostty";
+      process.env["GHOSTTY_RESOURCES_DIR"] = "/usr/share/ghostty";
+      const result = detectTerminal();
+      expect(result).not.toBeNull();
+      expect(result!.name).toBe("Ghostty");
+      // Both paths return Ghostty — but TERM_PROGRAM is checked first
+    });
+  });
+
   // -- LC_TERMINAL detection ---------------------------------------------
 
   describe("LC_TERMINAL detection", () => {
@@ -187,6 +217,13 @@ describe("detectTerminal", () => {
       expect(result!.name).toBe("Ghostty");
     });
 
+    test("TERM_PROGRAM (non-ghostty) takes precedence over GHOSTTY_RESOURCES_DIR", () => {
+      process.env["TERM_PROGRAM"] = "WezTerm";
+      process.env["GHOSTTY_RESOURCES_DIR"] = "/usr/share/ghostty";
+      const result = detectTerminal();
+      expect(result!.name).toBe("WezTerm");
+    });
+
     test("KITTY_WINDOW_ID takes precedence over TERM", () => {
       process.env["KITTY_WINDOW_ID"] = "12345";
       process.env["TERM"] = "alacritty";