Visão geral

O Ringly liga os hooks do Claude Code a notificações nativas do seu sistema operacional, com mensagens traduzidas e contextualizadas pelo nome do projeto. Você nunca mais precisa ficar olhando o terminal pra saber o que o Claude está esperando.

Por que ele existe

Quem usa o Claude Code passa horas com o terminal aberto. Mas, na prática, você abre o Claude, manda ele fazer alguma coisa, e vai pra outra aba. Cinco minutos depois lembra: “puxa, ele já terminou?”. Volta — e ele tá esperando há quatro minutos pra você confirmar uma permissão.

O Ringly resolve isso usando o sistema oficial de hooks do Claude Code. Quando o Claude termina, falha, ou pede input, o seu desktop dispara uma toast nativa. Não é polling. Não é daemon. Só hooks + um dispatcher de 3 KB.

Como ele é distribuído

O Ringly vem em duas camadas complementares e obrigatórias:

1. Pacote npm ringly — registra o AUMID do Windows (sem ele o ToastNotificationManager silencia o toast), cria o atalho no Menu Iniciar, escreve a configuração inicial e disponibiliza os utilitários ringly doctor / ringly config / ringly test / ringly uninstall.
2. Plugin do Claude Code — registra os 5 hooks (Notification, Stop, StopFailure, SubagentStop, SessionStart) e roda o dispatcher que delega ao módulo Node do ringly.

⚠️ Os dois passos são obrigatórios. O Windows 10/11 exige um AUMID registrado pro toast aparecer na Central de Ações — esse registro é feito apenas pelo ringly init. Sem ele, você ouve no máximo um beep.

Status de plataformas

Recurso	Windows 10/11	macOS	Linux
Toast nativo	✓	⏳	⏳
Som de fallback	✓	⏳	⏳
Registro AUMID	✓	—	—
Notificações em pt-BR/en-US	✓	✓	✓
TUI e CLI em pt-BR/en-US	✓	✓	✓

Windows 10/11 é a plataforma suportada na v1.0. macOS e Linux têm os back-ends estruturados e estão planejados pra próxima versão.

O que ler em seguida

• Instalação — passo a passo dos dois comandos
• Configuração — todas as opções e como mudá-las
• Comandos da CLI — referência dos 8 subcomandos
• Como funciona — arquitetura do dispatcher e dos hooks