Agent Toast — eventos de Claude Code como notificaciones de Windows

Si dejas corriendo tareas largas con Claude Code y te pones a hacer otra cosa, terminas revisando la terminal una y otra vez para ver si ya acabaron. Para resolver esa incomodidad, publico una app open source para Windows.

GitHub: https://github.com/hopoduck/agent-toast

¿Qué tipo de app es?

Usa el sistema de Hooks de Claude Code (o Codex CLI) para mostrar notificaciones toast de Windows cuando ocurren eventos como finalización de tareas, solicitudes de permisos o espera de entrada.

Notificaciones inteligentes — con un solo clic en la notificación, la ventana de la terminal correspondiente se activa de inmediato, y cuando vuelves a la terminal la notificación desaparece automáticamente. Si la terminal ya tiene el foco, la notificación ni siquiera se muestra, para no interrumpir el flujo de trabajo.

Funciones principales

• Notificaciones inteligentes: clic en la notificación → activación inmediata de la terminal, desaparición automática al volver a la terminal, omisión de la notificación si ya está enfocada
• 15 eventos de Hook: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact, etc.
• Multimonitor y posición en 4 esquinas: compatible con escalado DPI
• Compatibilidad con Codex CLI: también recibe como notificaciones los eventos de OpenAI Codex CLI
• Actualizaciones automáticas dentro de la app: basadas en GitHub Releases
• Soporte para coreano / inglés

Instalación

En la página de Releases puedes descargar directamente el instalador (Agent.Toast_*_x64-setup.exe) o el ejecutable portable (agent-toast.exe).

Cómo usarla

1. Ejecuta la app y, en la ventana de configuración, activa los eventos de hook que quieras y guarda
2. Los hooks se registran automáticamente en ~/.claude/settings.json
3. En la terminal de Claude Code, escribe /hooks y luego actualiza para aplicar los cambios

Stack tecnológico

Rust + Tauri v2 + Vue 3 + TypeScript (licencia MIT)

Cómo funciona

• Gestión de instancia única con Named Pipe — en el primer arranque se abre la app, y después las llamadas desde CLI envían JSON por el pipe y terminan de inmediato
• Detección en tiempo real de cambios de foco con la API de Win32 para hacer que las notificaciones desaparezcan automáticamente
• Exploración del árbol de procesos para mejorar la precisión al detectar la ventana de la terminal desde --pid

Espero que le sirva a quienes usan agentes como Claude Code. ¡No duden en dejar feedback en GitHub Issues!

[princox]

Lo configuré con Hooks para mapear los sonidos de Warcraft 3.
"Jobs done"

[hopoduck]

Está divertido eso de Jobs done jaja. Si además usan Agent Toast, al hacer clic en la notificación pueden cambiar de inmediato a la terminal, y cuando ya están viendo la terminal evita que aparezca la notificación, así que combinado con sonidos de Warcraft les va a resultar todavía más cómodo. También estaría bueno agregar personalización de sonidos.