convez.ai
PluginProdutividadeIntermediário
CristianBudala

Claude Code Notify

CristianBudala/Claude-Code-notify

Notificações desktop para Claude Code que ignora Do Not Disturb

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema 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-notify

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

  • python3 with python3-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:

  1. Check all dependencies
  2. Copy scripts to ~/.claude/
  3. 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: 4 seconds)

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

DesktopDisplay ServerStatus
CinnamonX11✅ Tested
GNOMEX11⚠️ Untested
KDEX11⚠️ Untested
AnyWayland⚠️ Untested
Ver o original no GitHub

Bom para

Relacionados