convez.ai
HookProdutividadeIniciante
totigm

Notificações Sonoras para Claude Code

totigm/claude-sound-notification

Sons distintos para conclusão de tarefas vs. solicitação de entrada

Ver no GitHub
BomPluginScore · de 0 a 100

Hook multiplataforma que toca sons distintos quando Claude termina uma tarefa versus quando precisa de sua entrada. Funciona nativamente em macOS, Linux e Windows com instalação não-destrutiva e sem modificar arquivos de configuração.

Instalação

$npx convez-ai totigm/claude-sound-notification

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
9
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Saber quando Claude terminou uma tarefa sem precisar checar constantemente
  • Receber feedback auditivo quando Claude aguarda sua resposta ou permissão
  • Trabalhar em modo hands-free, focando em outras atividades enquanto aguarda

Veredito

Hook prático e bem executado que reduz fricção no fluxo de trabalho com Claude Code. Suporte multiplataforma robusto e customização acessível justificam a implementação simples em shell.

README

A tradução para o português deste README ainda está na fila.

Claude Code Sound Notifications

Get audio notifications from Claude Code. Different sounds for when Claude finishes a task vs when it needs your input.

Install

Inside Claude Code:

/plugin marketplace add totigm/claude-sound-notification
/plugin install claude-sound-notification@claude-sound-notification
/reload-plugins

(For local development, point marketplace add at the cloned directory instead of the GitHub slug.)

What it does

Plays different sounds for two events:

  • Task complete (Stop) — Claude finished working.
  • Needs input (Notification) — Claude is asking for permission or user input.

This way you know whether to just check results or go respond.

Platform Support

PlatformPlayerTask CompleteNeeds Input
macOSafplayGlass.aiffFunk.aiff
Linuxpaplay → aplay → mpvcomplete.ogamessage.oga
WindowsPowerShell Media.SoundPlayerchimes.wavnotify.wav

The plugin auto-detects your OS at runtime. Falls back to the terminal bell (\a) if nothing else works.

Linux audio players

Install one of these on Linux:

# Ubuntu/Debian — PulseAudio
sudo apt install pulseaudio-utils

# Or ALSA
sudo apt install alsa-utils

# Or mpv
sudo apt install mpv

Windows

Run Claude Code under Git Bash, WSL, or MSYS2 so the hook's bash shebang resolves. PowerShell is used internally to play sounds.

Uninstall

Inside Claude Code:

/plugin uninstall claude-sound-notification

The plugin does not modify ~/.claude/settings.json, so uninstall is clean — nothing to undo by hand.

Customizing the sound

Edit hooks/play.sh in your local clone, then push to your own fork and install from there:

/plugin marketplace add <your-github-user>/claude-sound-notification
/plugin install claude-sound-notification@claude-sound-notification

Suggested sound files to drop in:

macOS system sounds: Glass.aiff · Funk.aiff · Pop.aiff · Submarine.aiff · Hero.aiff (all under /System/Library/Sounds/).

Windows sounds: chimes.wav · notify.wav · tada.wav · ding.wav (all under C:\Windows\Media\).

Linux: any .oga, .wav, or .mp3 file your chosen player supports.

License

MIT

Ver o original no GitHub

Bom para

Relacionados