Claude Notifications (plugin)
Smart notifications for Claude Code with click-to-focus, git branch display, and webhook integrations.
Boost your productivity — check out the advanced task manager for Claude with a convenient UI, from the creator of this plugin.
Table of Contents
Features
- Cross-platform: macOS (Intel & Apple Silicon), Linux (x64 & ARM64), Windows 10+ (x64)
- 6 notification types: Task Complete, Review Complete, Question, Plan Ready, Session Limit, API Error
- Click-to-focus (macOS, Linux): click notification to focus the exact project window and tab — Ghostty, VS Code, iTerm2, Warp, kitty, WezTerm, Alacritty, Hyper, Apple Terminal, GNOME Terminal, Konsole, Tilix, Terminator, XFCE4 Terminal, MATE Terminal
- Multiplexers: tmux (including iTerm2 -CC integration mode), zellij, WezTerm, kitty — click switches to the correct session/pane/tab
- Git branch in title:
✅ Completed main [cat]
- Sounds: MP3/WAV/FLAC/OGG/AIFF, volume control, audio device selection
- Webhooks: Slack, Discord, Telegram, Lark/Feishu, Microsoft Teams, ntfy.sh, PagerDuty, Zapier, n8n, Make, custom — with retry, circuit breaker, rate limiting (docs)
- Plugin compatibility: works with double-shot-latte and other plugins that spawn background Claude instances
Installation
Prerequisites
- Claude Code
- Windows users: Git Bash (included with Git for Windows) or WSL
- macOS/Linux users: No additional software required
Quick Install (Recommended)
One command to install everything:
curl -fsSL https://raw.githubusercontent.com/777genius/claude-notifications-go/main/bin/bootstrap.sh | bash
Then restart Claude Code and optionally run /claude-notifications-go:settings to configure sounds.
The binary is downloaded once and cached locally. You can re-run /claude-notifications-go:settings anytime to reconfigure.
If the bootstrap script doesn't work for your environment, use the Manual Install steps below inside Claude Code.
Manual Install
Step-by-step installation inside Claude Code (if bootstrap doesn't work)
Run these slash commands in the Claude Code chat, not in your system terminal:
# 1) Add marketplace
/plugin marketplace add 777genius/claude-notifications-go
# 2) Install plugin
/plugin install claude-notifications-go@claude-notifications-go
# 3) Restart Claude Code
# 4) Download binary
/claude-notifications-go:init
# 5) (Optional) Configure sounds and settings
/claude-notifications-go:settings
Having issues with installation? See Troubleshooting.
Updating
Run the same command as for installation — it will update both the plugin and the binary:
