Paneherd Notify
A Claude Code plugin that shows a desktop notification when a session needs you:
- Your turn: Claude finished its turn
- Needs permission: a permission prompt has been waiting for a few seconds
- Has a question: Claude is asking you something
Each notification names the folder the session runs in, so with several sessions open you know which one to switch to.
Claude Code sends a desktop notification on its own only in a few terminals (Ghostty, Kitty, iTerm2). In the VS Code and Cursor terminals, Warp and most others you get nothing by default. This plugin fills that gap.
Install
From a Claude Code session:
/plugin install paneherd-notify --marketplace erenxcolakx/paneherd-notify
Or from your shell:
claude plugin marketplace add erenxcolakx/paneherd-notify
claude plugin install paneherd-notify@paneherd
Start a new session and you're done. There is nothing to configure.
What it does on each system
| System | Notification |
|---|
| macOS | Notification Center banner with the Glass sound (osascript) |
| Windows | Windows toast with the default sound (PowerShell); the system chime if toasts are turned off |
| Linux | notify-send, if a notification daemon is running; otherwise the terminal bell |
| WSL | notify-send if available; otherwise the Windows chime |
On macOS, notifications from osascript go through Script Editor. If none appear, run osascript -e 'display notification "test"' once in Terminal, then allow Script Editor under System Settings > Notifications.
How it works
The plugin adds three hooks: Stop, and Notification for permission_prompt and elicitation_dialog. Each runs scripts/notify.sh, a short shell script you can read in full. The hooks run with async: true, so they never slow Claude down.
The script reads the hook's JSON input only to take the folder name from its cwd field. It shows the notification with your system's own tools, sends nothing over the network, writes no files, and collects nothing.
Permission notifications follow Claude Code's own timing: a prompt you answer within about six seconds doesn't notify you.
Privacy
Paneherd Notify collects no data. It makes no network requests, writes no files, and has no telemetry. The only input it reads is the JSON that Claude Code passes to the hook, and from that only the cwd field, to put the folder name in the notification. The notification is shown by your operating system's own tools: osascript on macOS, PowerShell on Windows, notify-send on Linux.
Support
Open an issue at https://github.com/erenxcolakx/paneherd-notify/issues.
Turn it off
/plugin disable paneherd-notify@paneherd, or uninstall it with /plugin uninstall paneherd-notify@paneherd.
Running many sessions?
Notifications tell you that a session needs you. If you run several Claude Code sessions side by side, Paneherd is a VS Code / Cursor extension that shows them in one grid with a live status on every pane. It notifies for its own panes, so this plugin stays quiet inside a Paneherd pane and you don't get two notifications.
License
MIT
