cvox — Notificações por Voz para Claude Code
lmk123/cvox
Alertas de voz quando Claude Code precisa de atenção — trabalhe sem olhar a tela
Ver no GitHubHook que emite alertas falados ou notificações desktop quando Claude Code precisa de permissão ou completa uma tarefa. Funciona nativamente no Claude Code CLI e Claude Desktop app com suporte multiplataforma (macOS, Linux, Windows).
Instalação
npx convez-ai lmk123/cvox1 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 auditivos quando Claude Code solicita permissão
- Notificações ao término de tarefas longas no Claude Desktop app
- Monitoramento multitarefa sem necessidade de acompanhamento visual
Veredito

Ferramenta prática que integra notificações por voz nativamente em ambientes Claude. Configuração simples e suporte multiplataforma sólido tornam-a útil para workflows que exigem monitoramento contínuo sem foco visual constante.
README
A tradução para o português deste README ainda está na fila.
cvox
Voice notifications for Claude Code and the Claude Desktop app. Get spoken alerts or desktop notifications when Claude needs permission or finishes a task — so you can step away from the screen.
Upgrading from v1? Bump to v2 (or later) and re-run cvox init to pick up Claude Desktop app support.
Features
- Works with both the Claude Code CLI and the Claude Desktop app — one setup covers both
- Cross-platform TTS: macOS (
say), Linux (espeak), Windows (SAPI via PowerShell) - Cross-platform desktop notifications: macOS (
osascript), Linux (notify-send), Windows (PowerShell NotifyIcon) - Interactive setup: choose language and notification method (voice, desktop, or both)
- Two hook events: permission prompt and task completion
- Three-layer config merging: defaults →
~/.cvox.json→ project.cvox.json - Idempotent installation — safe to run multiple times
{project}placeholder in messages, auto-detected from directory name
Quick Start
# Install globally
npm install -g cvox
# Set up for your project
cvox init
# Or set up globally (applies to all projects)
cvox init --global
That's it. Claude Code and the Claude Desktop app will now speak to you when they need attention.
Uninstall
# Remove hooks from project settings
cvox remove
# Remove hooks from global settings
cvox remove --global
Configuration
Create a .cvox.json in your project root or home directory (~/.cvox.json) to customize behavior:
{
"project": "my app",
"hooks": {
"notification": {
"enabled": true,
"message": "Claude Code needs permission, from {project}"
},
"stop": {
"enabled": true,
"message": "Claude Code task completed, from {project}"
}
},
"tts": {
"enabled": true
},
"desktop": {
"enabled": false
}
}
| Field | Type | Default | Description |
|---|---|---|---|
project | string | directory name | Project name used in {project} placeholder |
hooks.notification.enabled | boolean | true | Enable alert on permission prompts |
hooks.notification.message | string | "Claude Code needs permission, from {project}" | Message for permission prompt |
hooks.stop.enabled | boolean | true | Enable alert on task completion |
hooks.stop.message | string | "Claude Code task completed, from {project}" | Message for task completion |
tts.enabled | boolean | true | Enable/disable TTS voice globally |
desktop.enabled | boolean | false | Enable/disable desktop notifications globally |
Config files are merged with deep merge — you only need to specify the fields you want to override.
How It Works
cvox initinjects hooks into thesettings.jsonshared by both the Claude Code CLI and the Claude Desktop app- When either surface triggers a hook event (permission prompt or stop), it pipes a JSON payload via stdin to
cvox notify cvox notifyreads the event, loads your config, and calls the platform TTS engine and/or desktop notification to alert you
License
MIT