Claude Code Notification

Envia notificações do Claude Code com sons personalizáveis e suporte multiplataforma.

Documentação

🔔 Ganchos de Notificação do Claude Code

⚠️ OBSOLETO: Este projeto foi substituído por cat-ccnotify-hook. Use o novo pacote independente para melhor desempenho e instalação mais fácil.

Experiência aprimorada do Claude Code com notificações automáticas de desktop e sons contextuais para todos os eventos. Sem necessidade de chamadas manuais de notificação — funciona automaticamente com todas as operações do Claude Code!

✨ Recursos

🔔 Notificações Automáticas: Intercepta TODAS as notificações do Claude Code e as aprimora
🎵 Sons Contextuais: Sons diferentes para sucesso, erro, aviso e outros tipos de evento
🚀 Zero Configuração: Detecção automática e aprimoramento dos tipos de notificação
📋 Mapeamento Inteligente de Sons: Análise inteligente do conteúdo da notificação para sons apropriados
🖱️ Integração Nativa com o Sistema: Usa os sistemas de notificação nativos do macOS/Windows/Linux

🚀 Início Rápido

Método 1: Configuração em Um Comando (Recomendado)

Execute isto no Claude Code:

cd /path/to/ccnotify && npm run setup-hooks

Método 2: Configuração Manual

Clone e compile:

git clone <this-repository>
cd ccnotify
npm install && npm run build

Execute a configuração:

npm run setup-hooks

Reinicie o Claude Code se ele estiver em execução

3. É Isso!

Todas as notificações do Claude Code agora terão automaticamente sons e estilos aprimorados. Nenhuma configuração adicional é necessária!

📱 Como Funciona

O gancho de notificação detecta e aprimora automaticamente todas as notificações do Claude Code:

Atribuição Automática de Sons

✅ Sucesso/Conclusão → Som Glass (macOS)
🚨 Erros/Falhas → Som Basso (macOS)
⚠️ Avisos/Atenção → Som Sosumi (macOS)
💡 Informações/Atualizações → Som Blow (macOS)
⏳ Progresso/Em andamento → Som Tink (macOS)

Exemplos em Ação

# Building a project
npm run build
# → Automatic success notification with Glass sound when complete
# → Automatic error notification with Basso sound if failed

# Running tests  
npm test
# → Automatic progress notification with Tink sound while running
# → Automatic completion notification when finished

# Git operations
git push origin main
# → Automatic notifications for each step with appropriate sounds

🎵 Sons Disponíveis

Som	Caso de Uso	Som no macOS
`success`	Conclusão de tarefa, sucesso	Glass
`error`	Erros, falhas	Basso
`warning`	Avisos, atenção necessária	Sosumi
`info`	Informações, atualizações de status	Blow
`progress`	Atualizações de progresso, trabalho em andamento	Tink
`reminder`	Lembretes, avisos	Ping
`default`	Som padrão de notificação do sistema	-
`silent`	Sem som	-

🛠️ Configuração Avançada

Personalizando Mapeamentos de Sons

Edite o script do gancho em hooks/notification-hook.js para personalizar os mapeamentos de sons:

// Example: Add custom sound rules
const customSoundRules = [
  { pattern: /deployment/i, sound: 'Ping' },
  { pattern: /security/i, sound: 'Funk' },
  { pattern: /backup/i, sound: 'Purr' }
];

Solução de Problemas

O gancho não está funcionando?

# Check if hook is properly installed
cat ~/.config/claude-code/settings.json | grep -A 10 "hooks"

# Verify hook script is executable
ls -la hooks/notification-hook.js

# Re-run setup if needed
npm run setup-hooks

Os sons não estão tocando?

# Test system sound (macOS)
afplay /System/Library/Sounds/Glass.aiff

# Check notification permissions in System Preferences

🌍 Exemplos do Mundo Real

Exemplos de Aprimoramento Automático

Operações do Claude Code → Notificações Aprimoradas

# File operations
"Create a new React component"
→ ✅ "Component created successfully" + Glass sound

# Build processes  
"Run the build process"
→ ⏳ "Build in progress..." + Tink sound
→ ✅ "Build completed successfully" + Glass sound

# Error scenarios
"Fix the TypeScript errors"
→ 🚨 "3 type errors found" + Basso sound

# Git operations
"Commit these changes"
→ ✅ "Changes committed successfully" + Glass sound

🔧 Desenvolvimento

Comandos de Desenvolvimento

npm run dev    # Development mode with auto-reload
npm run build  # Production build
npm start      # Start production server

Suporte a Plataformas

macOS: Suporte nativo completo com osascript e sons do sistema
Windows/Linux: Suporte multiplataforma via pacote node-notifier

Arquitetura

Implementação em TypeScript com segurança de tipos
Compatível com MCP (Model Context Protocol)
Alternância automática de implementação específica por plataforma
Sistema extensível de tipos de notificação

📋 Detalhes Técnicos

Arquitetura do Gancho

O gancho de notificação intercepta o sistema de notificações do Claude Code e o aprimora:

Interceptação: O gancho recebe todas as chamadas de notificação do Claude Code
Análise: Analisa o conteúdo da notificação usando correspondência de padrões
Aprimoramento: Adiciona sons e estilos apropriados com base no conteúdo
Integração Nativa: Usa APIs de notificação específicas da plataforma

Estrutura de Instalação

~/.config/claude-code/settings.json  # Claude Code configuration
hooks/notification-hook.js            # Main hook script  
dist/index.js                        # Built MCP server (optional)
scripts/setup-hooks.js               # Automated setup script

Suporte a Plataformas

macOS: Suporte nativo completo com osascript e sons do sistema
Windows/Linux: Suporte multiplataforma via pacote node-notifier

Servidor MCP Legado (Opcional)

Para usuários avançados que desejam controle manual de notificações, o servidor MCP ainda está disponível:

{
  "mcpServers": {
    "ccnotify": {
      "command": "node",
      "args": ["/absolute/path/to/ccnotify/dist/index.js"]
    }
  }
}

🤝 Contribuindo

Relatórios de bugs e solicitações de recursos são bem-vindos! Por favor, abra uma issue.

📄 Licença

Licença MIT