Instalação

A instalação é feita em dois passos. Pular um deles é a única forma do toast nativo não aparecer — não é escolha de design, é exigência do próprio Windows 10/11 (veja a seção sobre AUMID abaixo).

Passo 1 — Instalar a CLI ringly

No terminal:

npm install -g ringly
ringly init

O instalador interativo faz tudo isso por você:

• registra o AUMID Claude.Code.CLI no Windows (obrigatório pro ToastNotificationManager autorizar o toast),
• cria o atalho no Menu Iniciar amarrado a esse AUMID,
• salva a configuração inicial no ~/.claude/settings.json (com backup automático),
• imprime o comando exato do passo 2 pra você colar no Claude Code.

Modo não-interativo

Se você está em CI ou prefere aplicar defaults sem TUI:

ringly init --non-interactive

Aplica idioma auto, todos os eventos exceto SubagentStop ligados, som ligado, debug desligado, e checagem de update ligada.

Passo 2 — Instalar o plugin no Claude Code

Dentro do Claude Code:

/plugin marketplace add nickdevcode/Ringly
/plugin install ringly@ringly

O plugin registra os 5 hooks (Notification, Stop, StopFailure, SubagentStop, SessionStart) e o dispatcher embutido passa a usar o AUMID já registrado no passo 1.

A partir daí, configure idioma, eventos, som e debug pelo ringly config (TUI) ou editando ~/.claude/settings.json direto.

Verificando a instalação

Roda o doctor pra ver se está tudo ok:

ringly doctor

Você deve ver algo como:

9 passou · 0 avisos · 0 falhou

Se houver alertas, o próprio comando aponta o que fazer.

E pra disparar uma toast de teste:

ringly test --event Stop

Deve aparecer um toast no canto inferior direito da tela em alguns instantes.

Sobre o AUMID

O Application User Model ID é como o Windows 10/11 identifica apps que disparam toasts. O ToastNotificationManager exige que esse ID esteja registrado no sistema pra autorizar a exibição da notificação na Central de Ações.

O Ringly usa Claude.Code.CLI como AUMID e registra ele automaticamente no ringly init, junto com um atalho de Menu Iniciar que aponta pra esse ID. Sem isso registrado, o Windows silencia a toast por design — sem aviso, sem erro, nada.

É por isso que pular o passo 1 não funciona, mesmo que o plugin esteja registrado no Claude Code.

Solução rápida de problemas

• Não aparece toast. Confira Modo Foco / Não Perturbe no Windows. Rode ringly doctor pra inspecionar o registro AUMID e as permissões.
• AUMID ausente após reinstalar. Rode ringly init --force pra recriar o atalho do Menu Iniciar e re-registrar o ID.
• Hook parece silencioso. Ative debug: true rodando ringly config e veja o log indicado no fim do ringly doctor.

Mais detalhes em Troubleshooting.