diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-15 03:25:50 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-05-15 03:25:50 +0300 |
| commit | fdf6a0180d3cc1ee6631107526cf26212f283d08 (patch) | |
| tree | 262218d3d552fb44910e43bff49a00467f84a3aa /.pi | |
| parent | bfe2f84f4fc8f37517eaadfa3274eb0ff79b47ab (diff) | |
fix: improve macos system notifications
Diffstat (limited to '.pi')
| -rw-r--r-- | .pi/docs/CONFIGURATION.md | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/.pi/docs/CONFIGURATION.md b/.pi/docs/CONFIGURATION.md index 25f17b5a..4da0c565 100644 --- a/.pi/docs/CONFIGURATION.md +++ b/.pi/docs/CONFIGURATION.md @@ -299,8 +299,20 @@ delivery = "off" available values: - `off` — disable popup notifications - `herdr` — show top-right in-app toasts -- `terminal` — ask the outer terminal to show a desktop notification. Some terminals suppress foreground notifications, including Ghostty on macOS. -- `system` — ask the OS notification service directly. macOS uses `osascript`; Linux requires `notify-send`. +- `terminal` — ask the outer terminal to show a desktop notification. some terminals suppress foreground notifications, including ghostty on macos. +- `system` — ask the os notification service directly. on macos, herdr uses `terminal-notifier` when available and falls back to built-in `osascript`. on linux, `system` requires `notify-send`. + +### macos system notifications + +for best macos support, install `terminal-notifier`: + +```sh +brew install terminal-notifier +``` + +when `terminal-notifier` is installed, herdr shows the herdr icon in system notifications. herdr also tries to focus the hosting terminal when a notification is clicked. click-to-return is supported for detected ghostty, iterm2, wezterm, kitty, alacritty, and terminal.app sessions. + +without `terminal-notifier`, herdr falls back to built-in `osascript`. this still shows a macos notification, but it cannot set the herdr icon and clicking the notification may focus the apple script runner instead of returning to your terminal. compatibility note: - older configs may still use `ui.toast.enabled = true|false` @@ -313,7 +325,9 @@ current behavior: - shown for background agent events like `needs attention` and `finished` - suppression is tab-aware: the active tab stays quiet, but background tabs in the same workspace can still notify - `terminal` delivery is best-effort and depends on terminal support -- currently targets terminals such as Ghostty, Kitty, iTerm2, and WezTerm +- `system` delivery is best-effort and depends on the os helper being available +- macos `system` delivery prefers `terminal-notifier` when present and falls back to `osascript` +- currently targets terminals such as ghostty, kitty, iterm2, and wezterm - inside tmux, herdr wraps notification escapes with tmux passthrough ## sound |