omni-notify-mcp 1.1.1 → 1.1.4

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/logo.svg" width="128" height="128" alt="omni-notify-mcp">
+  <img src="https://raw.githubusercontent.com/menih/notify-mcp/main/assets/logo.svg" width="128" height="128" alt="omni-notify-mcp">
 </p>
 
 <h1 align="center">omni-notify-mcp</h1>
@@ -13,8 +13,13 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/omni-notify-mcp"><img src="https://img.shields.io/npm/v/omni-notify-mcp.svg" alt="npm"></a>
-  <img src="https://img.shields.io/badge/license-MIT-7c6dfa.svg" alt="MIT license">
-  <img src="https://img.shields.io/badge/MCP-compatible-3b82f6.svg" alt="MCP compatible">
+  <a href="https://marketplace.visualstudio.com/items?itemName=MeniHillel.omni-notify-mcp"><img src="https://img.shields.io/visual-studio-marketplace/v/MeniHillel.omni-notify-mcp?label=marketplace" alt="VS Code Marketplace"></a>
+  <img src="https://img.shields.io/badge/license-MIT-4ea3ff.svg" alt="MIT license">
+  <img src="https://img.shields.io/badge/MCP-compatible-4ea3ff.svg" alt="MCP compatible">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/menih/notify-mcp/main/assets/screenshots/main-ui.png" width="900" alt="omni-notify-mcp config UI — channels and policies side by side, with live activity log">
 </p>
 
 ---
@@ -107,7 +112,11 @@ The server publishes a policy `{ enabled, thresholdSeconds }`. Agents are **inst
 Cross-platform idle detection: Windows (PowerShell + `GetLastInputInfo`), macOS (`ioreg`), Linux (`xprintidle`).
 
 ### Web config UI
-One page, dark theme, live activity log streaming over SSE, one-click test buttons per channel, secrets masked at rest.
+One page, dark theme, live activity log streaming over SSE, one-click test buttons per channel, secrets masked at rest. Plus a copy-paste help page that walks any AI client through registration in 30 seconds:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/menih/notify-mcp/main/assets/screenshots/help-page.png" width="800" alt="Help page — copy-paste snippets for Claude Code, Cursor, VS Code, Claude Desktop, Windsurf, Zed">
+</p>
 
 ### Activity log
 Every notify, ask, reply, and inbox event is logged with timestamp, direction (`→` `←` `·`), channel, and (color-coded) client/session id. Visible live in the UI; last 500 entries replayed on connect.

package/dist/channels/desktop.js

@@ -9,7 +9,7 @@ export async function sendDesktop(config, message) {
     if (wantSound && process.platform === "win32") {
         spawn("powershell", [
             "-NoProfile", "-Command",
-            "[console]::beep(880,180); Start-Sleep -Milliseconds 60; [console]::beep(660,180)",
+            "Add-Type -AssemblyName System.Windows.Forms; [System.Media.SystemSounds]::Asterisk.Play(); Start-Sleep -Milliseconds 600",
         ], { windowsHide: true, stdio: "ignore" });
     }
     await new Promise((resolve, reject) => {

package/dist/ui/server.js

@@ -150,15 +150,15 @@ app.post("/api/config", (req, res) => {
 // node-notifier's `sound: true` works reliably, no fallback needed.
 app.post("/api/test/sound", (_req, res) => {
     if (process.platform === "win32") {
-        // Direct PowerShell beep — bypasses the notification subsystem entirely.
-        // Plays an 800Hz tone for 200ms through the system speakers. Cannot be
-        // muted by per-app notification settings.
+        // Use System.Media.SystemSounds.Asterisk — plays through the sound card
+        // (Windows notification sound), works on every machine. console::beep
+        // uses the PC speaker which modern hardware lacks.
         spawn("powershell", [
             "-NoProfile",
             "-Command",
-            "[console]::beep(880,180); Start-Sleep -Milliseconds 60; [console]::beep(660,180)",
+            "Add-Type -AssemblyName System.Windows.Forms; [System.Media.SystemSounds]::Asterisk.Play(); Start-Sleep -Milliseconds 600",
         ], { windowsHide: true, stdio: "ignore" });
-        res.json({ ok: true, message: "Beep sent (Windows console.beep)" });
+        res.json({ ok: true, message: "Sound played (System.Media)" });
         return;
     }
     notifier.notify({ title: "Claude Notify", message: "Sound test", sound: true, wait: false }, (err) => {
@@ -175,7 +175,7 @@ app.post("/api/test/desktop", (_req, res) => {
     if (wantSound && process.platform === "win32") {
         spawn("powershell", [
             "-NoProfile", "-Command",
-            "[console]::beep(880,180); Start-Sleep -Milliseconds 60; [console]::beep(660,180)",
+            "Add-Type -AssemblyName System.Windows.Forms; [System.Media.SystemSounds]::Asterisk.Play(); Start-Sleep -Milliseconds 600",
         ], { windowsHide: true, stdio: "ignore" });
     }
     notifier.notify({
@@ -558,9 +558,13 @@ async function sendNotification(message, priority, client) {
             // Windows notification settings — fire a PowerShell beep alongside the
             // toast so the audible cue is reliable. macOS/Linux: trust the OS.
             if (wantSound && process.platform === "win32") {
+                // [console]::beep uses the PC speaker (motherboard buzzer), which
+                // modern laptops/desktops don't have — silent on most machines.
+                // SystemSounds.Asterisk plays through the actual sound card via
+                // the Windows notification sound, audible on every machine.
                 spawn("powershell", [
                     "-NoProfile", "-Command",
-                    "[console]::beep(880,180); Start-Sleep -Milliseconds 60; [console]::beep(660,180)",
+                    "Add-Type -AssemblyName System.Windows.Forms; [System.Media.SystemSounds]::Asterisk.Play(); Start-Sleep -Milliseconds 600",
                 ], { windowsHide: true, stdio: "ignore" });
             }
             const soundOpt = wantSound && process.platform !== "win32";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-notify-mcp",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "description": "An MCP server that lets AI agents (Claude, Cursor, etc.) reach you on any channel — desktop, Telegram, SMS, email — with two-way ask/reply, real-time inbox push, Do Not Disturb, idle gating, multi-session routing, and a one-page web UI for setup. Zero config code; configure once, agents call notify/ask.",
   "main": "dist/index.js",
   "type": "module",
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/menih/omni-notify-mcp"
+    "url": "https://github.com/menih/notify-mcp"
   },
   "engines": {
     "node": ">=18"
@@ -64,6 +64,7 @@
     "@types/node": "^20.0.0",
     "@types/node-notifier": "^8.0.5",
     "@types/nodemailer": "^6.4.14",
+    "playwright": "^1.59.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.4.0"
   }