Skip to content

armgit / ECC

Public Imported from GitHub
0

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.json
index 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.js
index 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}`);
}