The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(hooks): add WSL desktop notification support via PowerShell + BurntToast (#1019)
QWsin118e57e14bdc
diff --git a/hooks/hooks.json b/hooks/hooks.jsonindex e5507c946..785a3e4c4 100644--- a/hooks/hooks.json+++ b/hooks/hooks.json@@ -310,7 +310,7 @@"timeout": 10}],- "description": "Send macOS desktop notification with task summary when Claude responds"+ "description": "Send desktop notification (macOS/WSL) with task summary when Claude responds"}],"SessionEnd": [diff --git a/scripts/hooks/desktop-notify.js b/scripts/hooks/desktop-notify.jsindex 8d844e032..cfa62b7de 100644--- a/scripts/hooks/desktop-notify.js+++ b/scripts/hooks/desktop-notify.js@@ -3,9 +3,11 @@* Desktop Notification Hook (Stop)** Sends a native desktop notification with the task summary when Claude- * finishes responding. Currently supports macOS (osascript); other- * platforms exit silently. Windows (PowerShell) and Linux (notify-send)- * support is planned.+ * finishes responding. Supports:+ * - macOS: osascript (native)+ * - WSL: PowerShell 7 or Windows PowerShell + BurntToast module+ *+ * On WSL, if BurntToast is not installed, logs a tip for installation.** Hook ID : stop:desktop-notify* Profiles: standard, strict@@ -19,6 +21,64 @@ const { isMacOS, log } = require('../lib/utils');const TITLE = 'Claude Code';const MAX_BODY_LENGTH = 100;+/**+ * Memoized WSL detection at module load (avoids repeated /proc/version reads).+ */+let isWSL = false;+if (process.platform === 'linux') {+ try {+ isWSL = require('fs').readFileSync('/proc/version', 'utf8').toLowerCase().includes('microsoft');+ } catch {+ isWSL = false;+ }+}++/**+ * Find available PowerShell executable on WSL.+ * Returns first accessible path, or null if none found.+ */+function findPowerShell() {+ if (!isWSL) return null;++ const candidates = [+ 'pwsh.exe', // WSL interop resolves from Windows PATH+ 'powershell.exe', // WSL interop for Windows PowerShell+ '/mnt/c/Program Files/PowerShell/7/pwsh.exe', // PowerShell 7 (default install)+ '/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe', // Windows PowerShell+ ];++ for (const path of candidates) {+ try {+ const result = spawnSync(path, ['-Command', 'exit 0'],+ { stdio: ['ignore', 'pipe', 'ignore'], timeout: 3000 });+ if (result.status === 0) {+ return path;+ }+ } catch {+ // continue+ }+ }+ return null;+}++/**+ * Send a Windows Toast notification via PowerShell BurntToast.+ * Returns { success: boolean, reason: string|null }.+ * reason is null on success, or contains error detail on failure.+ */+function notifyWindows(pwshPath, title, body) {+ const safeBody = body.replace(/'/g, "''");+ const safeTitle = title.replace(/'/g, "''");+ const command = `Import-Module BurntToast; New-BurntToastNotification -Text '${safeTitle}', '${safeBody}'`;+ const result = spawnSync(pwshPath, ['-Command', command],+ { stdio: ['ignore', 'pipe', 'pipe'], timeout: 5000 });+ if (result.status === 0) {+ return { success: true, reason: null };+ }+ const errorMsg = result.error ? result.error.message : result.stderr?.toString();+ return { success: false, reason: errorMsg || `exit ${result.status}` };+}+/*** Extract a short summary from the last assistant message.* Takes the first non-empty line and truncates to MAX_BODY_LENGTH chars.@@ -53,20 +113,34 @@ function notifyMacOS(title, body) {}}-// TODO: future platform support-// function notifyWindows(title, body) { ... }-// function notifyLinux(title, body) { ... }-/*** Fast-path entry point for run-with-flags.js (avoids extra process spawn).*/function run(raw) {try {- if (!isMacOS) return raw;-const input = raw.trim() ? JSON.parse(raw) : {};const summary = extractSummary(input.last_assistant_message);- notifyMacOS(TITLE, summary);++ if (isMacOS) {+ notifyMacOS(TITLE, summary);+ } else if (isWSL) {+ const ps = findPowerShell();+ if (ps) {+ const { success, reason } = notifyWindows(ps, TITLE, summary);+ if (success) {+ // notification sent successfully+ } else if (reason && reason.toLowerCase().includes('burnttoast')) {+ // BurntToast module not found+ log('[DesktopNotify] Tip: Install BurntToast module to enable notifications');+ } else if (reason) {+ // Other PowerShell/notification error - log for debugging+ log(`[DesktopNotify] Notification failed: ${reason}`);+ }+ } else {+ // No PowerShell found+ log('[DesktopNotify] Tip: Install BurntToast module in PowerShell for notifications');+ }+ }} catch (err) {log(`[DesktopNotify] Error: ${err.message}`);}