Claude Code Notify
CristianBudala/Claude-Code-notify
Notificações desktop para Claude Code que ignora Do Not Disturb
Ver no GitHubSistema leve de notificações desktop para Claude Code que exibe popups quando prompts terminam ou Claude aguarda entrada do usuário. Funciona independentemente das configurações de Não Perturbe do sistema, com suporte a som customizável.
Instalação
npx convez-ai CristianBudala/Claude-Code-notify1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Receber alertas quando Claude termina de processar prompts longos
- Ser notificado quando Claude aguarda sua resposta
- Manter-se atento a interações do Claude Code sem depender de DND do sistema
Veredito

Plugin útil e bem estruturado para usuários de Claude Code que precisam de notificações confiáveis. Requer conhecimento básico de shell/Python e não é 100% testado em todos os ambientes de desktop, mas oferece bom controle de customização.
README
A tradução para o português deste README ainda está na fila.
██████╗██╗ █████╗ ██╗ ██╗██████╗ ███████╗
██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝
██║ ██║ ███████║██║ ██║██║ ██║█████╗
██║ ██║ ██╔══██║██║ ██║██║ ██║██╔══╝
╚██████╗███████╗██║ ██║╚██████╔╝██████╔╝███████╗
╚═════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
███╗ ██╗ ██████╗ ████████╗██╗███████╗██╗ ██╗
████╗ ██║██╔═══██╗╚══██╔══╝██║██╔════╝╚██╗ ██╔╝
██╔██╗ ██║██║ ██║ ██║ ██║█████╗ ╚████╔╝
██║╚██╗██║██║ ██║ ██║ ██║██╔══╝ ╚██╔╝
██║ ╚████║╚██████╔╝ ██║ ██║██║ ██║
╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝
A lightweight notification system for Claude Code that shows a custom popup when a prompt finishes or when Claude needs your input.
What it does
- Shows a desktop popup when Claude finishes a prompt
- Shows a popup when Claude is waiting for your input
- Plays a sound with each notification
- Works independently of system Do Not Disturb settings
Dependencies
python3withpython3-gi(GTK bindings)paplay(PulseAudio/PipeWire)jq(JSON processor)
On Debian/Ubuntu/Mint:
sudo apt install python3-gi paplay jq
Installation
git clone https://github.com/yourname/claude-notify.git
cd claude-notify
bash install.sh
The installer will:
- Check all dependencies
- Copy scripts to
~/.claude/ - Add hooks to
~/.claude/settings.json
If hooks already exist in settings.json, it will ask before overwriting.
Customization
Popup appearance
Edit ~/.claude/notify_popup.py:
- Colors, font size, border — modify the CSS block at the top
- Size — change
win.resize(width, height) - Position — change
win.move(x, y)(default: bottom right) - Duration — change the last argument in
notify.sh(default:4seconds)
Sound
Edit ~/.claude/notify_popup.py:
SOUND = "/usr/share/sounds/freedesktop/stereo/message-new-instant.oga"
Replace with any .oga or .wav file path.
Notification text
Edit ~/.claude/settings.json:
"command": "~/.claude/notify.sh 'Claude Code' '✴ Task completed'"
Compatibility
| Desktop | Display Server | Status |
|---|---|---|
| Cinnamon | X11 | ✅ Tested |
| GNOME | X11 | ⚠️ Untested |
| KDE | X11 | ⚠️ Untested |
| Any | Wayland | ⚠️ Untested |