opencode-osc9 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+<div align="right">
+
+<img src="./notification.png" width="400" />
+
+</div>
+
+# opencode-osc9
+
+A zero-dependency [opencode](https://opencode.ai) plugin that sends desktop notifications via [**OSC 9**](https://ghostty.org/docs/vt/osc/9) escape sequences when tasks complete.
+
+Works with any terminal that supports OSC 9, including **Ghostty**, **iTerm2**, **kitty**, **WezTerm**, and others.
+
+## Install
+
+Add `"opencode-osc9"` to the `plugins` array in your opencode config (usually `~/.config/opencode/opencode.jsonc`):
+
+```jsonc
+{
+  "plugin": ["opencode-osc9@latest"]
+}
+```
+
+## Try it
+
+You can test OSC 9 support in your terminal by running the included `try.ts`:
+
+> [!TIP]
+> Most terminals won't fire a notification if the window is focused so a 3 second delay is baked into the `try.ts` script to give you time to change app focus.
+
+```sh
+# bun
+bun try.ts
+
+# node (v24+)
+node try.ts
+```

package/dist/index.js

@@ -0,0 +1,53 @@
+// index.ts
+import { closeSync, openSync, writeSync } from "fs";
+function osc9(text) {
+  const safe = text.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 256);
+  return `\x1B]9;${safe}\x1B\\`;
+}
+async function notify(text, log) {
+  let fd;
+  try {
+    fd = openSync("/dev/tty", "w");
+    writeSync(fd, osc9(text));
+  } catch (err) {
+    await log({
+      body: {
+        service: "opencode-osc9",
+        level: "warn",
+        message: "Failed to notify",
+        extra: { text, err: err instanceof Error ? err.message : String(err) }
+      }
+    });
+  } finally {
+    if (fd !== undefined) {
+      try {
+        closeSync(fd);
+      } catch {}
+    }
+  }
+}
+var OpencodeOsc9 = async ({ client }) => {
+  return {
+    event: async ({ event }) => {
+      const { type, properties } = event;
+      switch (type) {
+        case "session.idle":
+          await notify("session idle", client.app.log);
+          break;
+        case "permission.ask": {
+          const perm = properties?.permission ?? "unknown";
+          await notify(`needs approval: ${perm}`, client.app.log);
+          break;
+        }
+        case "session.error": {
+          const err = properties?.error;
+          await notify(`error${err?.message ? ": " + err.message : ""}`, client.app.log);
+          break;
+        }
+      }
+    }
+  };
+};
+export {
+  OpencodeOsc9
+};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "opencode-osc9",
+  "version": "0.1.0",
+  "description": "opencode plugin to send system notification via OSC 9",
+  "author": "tbeseda",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "try.ts"
+  ],
+  "scripts": {
+    "build": "bun build index.ts --outdir dist --target node",
+    "prepublishOnly": "bun run build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.14.49",
+    "@types/bun": "^1.3.14",
+    "typescript": "^6"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "notifications",
+    "alerts"
+  ]
+}

package/try.ts

@@ -0,0 +1,27 @@
+// @ts-nocheck
+import { setTimeout } from "timers/promises"
+import { OpencodeOsc9 } from "./index.ts"
+
+const client = await OpencodeOsc9({
+  client: {
+    app: {
+      log(payload: any) {
+        console.error("Unable to send notification via OSC 9")
+        console.log(JSON.stringify(payload, null, 2))
+      }
+    }
+  }
+})
+
+console.log("Unfocus your terminal and wait 3 seconds")
+await setTimeout(3000)
+await client.event({
+  event: {
+    type: "session.error",
+    properties: {
+      error: { message: "agent ran rm -rf /" },
+    },
+  }
+})
+console.log("Error event sent")
+console.log("You should have seen a notification")