Bug Fixes

Windows toast and sound reliability (#90, #91)

Windows notifications now keep playing the configured sound even when the toast backend returns a doc.LoadXml(tmpl) false-positive. The Windows beeep path also pins the OS thread around the WinRT/COM call and downgrades successful PowerShell fallback errors to warnings instead of failed desktop notifications.

Konsole click-to-focus on KDE (#92)

Konsole detection now uses KONSOLE_VERSION and KONSOLE_DBUS_SESSION, so Linux focus helpers search for the correct konsole window class on KDE and Wayland.

Verification

• Ubuntu CI, macOS CI, and Windows CI passed on the release commit.
• Release workflow built Go binaries for macOS, Linux, and Windows.
• ClaudeNotifier.app.zip was built and uploaded with the release assets.
• Release binary smoke tests passed on Ubuntu, macOS, and Windows runners.

Contributors

Thanks @professor-k and @Loveshy1 for the focused fixes in this release.

📦 Installation · 🔄 Updating

Full Changelog: v1.39.3...v1.39.4

Contributors

• @professor-k
• @Loveshy1

Bug Fixes

Linux GNOME/Wayland click-to-focus reliability (#89)

GNOME focus now uses reverse-domain WM class/app IDs for Wayland-native terminals such as Ghostty and WezTerm, fixing notification clicks that could fail to raise the terminal window.

WezTerm exact pane focus on Linux (#89)

Notification clicks now carry WezTerm pane/socket hints from the hook process, raise the matching WezTerm window, then switch to the exact pane. Inherited WEZTERM_* variables are ignored for non-WezTerm focus targets to avoid focusing the wrong app.

📦 Installation · 🔄 Updating

Full Changelog: v1.39.2...v1.39.3

Fixed

• Windows Stop hooks no longer corrupt non-ASCII JSON payloads. Windows hook generation now uses direct exec-form .exe hooks with args instead of PowerShell or Git Bash shell pipelines, fixing #87.
• Bundled plugin hooks now use argument-vector execution by default, and installer validation rejects Windows hook configs that still route through shell commands, wrappers, .bat or .cmd shims, or $input pipes.
• Tmux terminal bell fallback now uses the pane tty when /dev/tty is unavailable (#86).

Verification

• Ubuntu CI, macOS CI, and Windows CI passed on 099aeee.
• Release workflow built all binaries, published checksums.txt, and smoke-tested Linux, macOS, and Windows release binaries.

Full Changelog: v1.39.1...v1.39.2

Bug Fixes

macOS notifications no longer steal focus (#82)

ClaudeNotifier.app now launches through open -g, so showing a notification does not briefly bring the notifier app to the foreground before any click handling.

Plugin setup commands stay out of model context (#83)

Setup and configuration slash commands are still manually available from the slash menu, but opt out of model invocation metadata to reduce prompt context overhead after setup.

📦 Installation · 🔄 Updating

Full Changelog: v1.39.0...v1.39.1

New Features

Discord native embeds

Discord webhook notifications now render structured native embeds with author, fields, and footer data.

Windows PowerShell hook generation (#78)

Added claude-notifications windows-hooks so Windows installs can generate Claude hook config that calls the native .exe through PowerShell.

Ghostty click-to-focus targeting (#78)

Improved macOS Ghostty click-to-focus so notifications can target and remember a specific terminal instance more accurately.

Bug Fixes

Windows hooks no longer depend on Git Bash (#79, #80)

The installer now rewrites PreToolUse, Notification, Stop, SubagentStop, and TeammateIdle hooks to call the Windows .exe directly through PowerShell with an absolute path. This avoids silent hook-wrapper.sh launch failures on Windows 10/11 and preserves lazy update behavior for direct .exe hooks.

Discord embed robustness

Discord webhook rendering now skips empty embed fields and clamps overlong author names before sending payloads.

Maintenance

Status config cleanup

Removed the legacy Ghostty keywords field from generated status configuration and aligned architecture documentation.

Contributors

Thanks to @taige for the Discord embed and status config contributions.

📦 Installation · 🔄 Updating

Full Changelog: v1.38.0...v1.39.0

Full Changelog: v1.37.0...v1.38.0

Added

Webhook payload templates

Custom webhook bodies can now reference richer runtime fields such as session metadata, git context, cwd-derived values, and rendered notification content. This makes Slack, Lark, and custom webhook integrations much easier to shape without patching the plugin.

Fixed

Installer download verification

Release asset validation is stricter and safer before replacing installed binaries, which reduces the risk of corrupted or suspicious downloads being applied during updates.

Ghostty exact tab focus (#72)

Click-to-focus now tries Ghostty's native AppleScript terminal focus first, so notification clicks can switch to the correct tab instead of only raising the window. If Automation is unavailable or the exact terminal cannot be resolved, it safely falls back to the previous AXDocument window-level path.

🔄 Updating

Full Changelog: v1.36.7...v1.37.0

What's Changed

• fix: restore minimized macos windows before focusing by @777genius in #68

Full Changelog: v1.36.6...v1.36.7

Contributors

• @777genius

Bug Fixes

iTerm2 degraded click-to-focus UX

• Fixed iTerm2 click-to-focus fallback so it no longer drops into the generic Screen Recording-based window matcher when the Python API helper is unavailable.
• When iTerm2 Python API is disabled or temporarily broken after toggling it, the plugin now falls back to plain iTerm activation and shows clearer guidance instead of prompting for the wrong permission.

iTerm2 setup guidance

• Improved bootstrap and runtime guidance for iTerm2 users, including the exact settings path: iTerm2 > Settings > General > Magic > Python API.
• Bootstrap now highlights this requirement up front so exact tab and pane focusing is easier to enable during install.

📦 Installation · 🔄 Updating

Full Changelog: v1.36.5...v1.36.6

Bug Fixes

iTerm2 Click-To-Focus Reliability (#63)

• Fixed a macOS ClaudeNotifier bundle configuration issue that could prevent Notification Center clicks from relaunching the notifier callback on iTerm2.
• Fixed exact iTerm2 tab targeting by normalizing ITERM_SESSION_ID values to match the Python API termid format, so notification clicks open the correct tab more reliably.

📦 Installation · 🔄 Updating

Full Changelog: v1.36.4...v1.36.5