Agent Toast — eventos do Claude Code como notificações do Windows
(github.com/hopoduck)Quando você deixa uma tarefa longa rodando no Claude Code e vai fazer outra coisa, acaba tendo que ficar checando o terminal para ver se ela terminou. Estou lançando um aplicativo open source para Windows criado para eliminar esse incômodo.
GitHub: https://github.com/hopoduck/agent-toast
Que aplicativo é esse?
Usando o sistema de Hooks do Claude Code (ou do Codex CLI), ele exibe notificações toast do Windows quando ocorrem eventos como conclusão de tarefa, solicitação de permissão ou espera por entrada.
Notificações inteligentes — com um clique na notificação, a janela do terminal correspondente é ativada imediatamente; ao voltar para o terminal, a notificação desaparece automaticamente. Se o terminal já estiver em foco, a notificação nem é exibida, para não atrapalhar o fluxo de trabalho.
Principais recursos
- Notificações inteligentes: clique na notificação → terminal ativado imediatamente; ao retornar ao terminal, a notificação some automaticamente; se já estiver em foco, a notificação é omitida
- 15 eventos de Hook: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact etc.
- Multimonitor e posição nos 4 cantos: com suporte a escala DPI
- Suporte ao Codex CLI: também recebe eventos do OpenAI Codex CLI como notificações
- Atualização automática no app: baseada no GitHub Releases
- Suporte a coreano / inglês
Instalação
Na página de Releases, você pode baixar diretamente o instalador (Agent.Toast_*_x64-setup.exe) ou o executável portátil (agent-toast.exe).
Como usar
- Execute o app, ative e salve os eventos de hook desejados na janela de configurações
- O hook é registrado automaticamente em
~/.claude/settings.json - No terminal do Claude Code, digite
/hookse atualize para concluir a aplicação
Stack técnica
Rust + Tauri v2 + Vue 3 + TypeScript (licença MIT)
Como funciona
- Gerenciamento de instância única com Named Pipe — na primeira execução o app é iniciado; depois disso, chamadas via CLI enviam JSON pelo pipe e encerram imediatamente
- Detecção em tempo real de mudanças de foco com a API Win32 para remover notificações automaticamente
- Navegação pela árvore de processos para melhorar a precisão da detecção da janela do terminal a partir de
--pid
Espero que isso seja útil para usuários de agentes como o Claude Code. Fiquem à vontade para deixar feedback no GitHub Issues!
2 comentários
Mapeei os sons do Warcraft 3 com Hooks.
"Jobs done"
O esquema de Jobs done é bem divertido kkk. Aliás, se você também usar o Agent Toast, dá para mudar na hora para o terminal ao clicar na notificação, e como ele evita mostrar notificação quando você já está olhando o terminal, combinado com o som de Warcraft fica ainda mais prático! Também seria legal adicionar personalização de som.