convez.ai
HookIntegração & APIsIntermediário
lmk123

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 GitHub
InicialPluginScore · de 0 a 100

Hook 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/cvox

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
4
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
v3.1.0
Issues abertas
1
Contribuidores
1

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

npm version

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
  }
}
FieldTypeDefaultDescription
projectstringdirectory nameProject name used in {project} placeholder
hooks.notification.enabledbooleantrueEnable alert on permission prompts
hooks.notification.messagestring"Claude Code needs permission, from {project}"Message for permission prompt
hooks.stop.enabledbooleantrueEnable alert on task completion
hooks.stop.messagestring"Claude Code task completed, from {project}"Message for task completion
tts.enabledbooleantrueEnable/disable TTS voice globally
desktop.enabledbooleanfalseEnable/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

  1. cvox init injects hooks into the settings.json shared by both the Claude Code CLI and the Claude Desktop app
  2. When either surface triggers a hook event (permission prompt or stop), it pipes a JSON payload via stdin to cvox notify
  3. cvox notify reads the event, loads your config, and calls the platform TTS engine and/or desktop notification to alert you

License

MIT

Ver o original no GitHub

Bom para

Relacionados