Agent Toast — Claude Code-Ereignisse als Windows-Benachrichtigungen
(github.com/hopoduck)Wenn man mit Claude Code lange Aufgaben laufen lässt und währenddessen etwas anderes macht, schaut man am Ende ständig ins Terminal, um zu sehen, ob die Aufgabe fertig ist. Um diese Unannehmlichkeit zu beseitigen, veröffentliche ich eine Open-Source-Windows-App, die genau dafür entwickelt wurde.
GitHub: https://github.com/hopoduck/agent-toast
Was ist das für eine App?
Über das Hook-System von Claude Code (oder Codex CLI) zeigt sie Windows-Toast-Benachrichtigungen an, wenn Ereignisse wie Aufgabenabschluss, Berechtigungsanfragen oder das Warten auf Eingaben auftreten.
Intelligente Benachrichtigungen — Mit einem Klick auf die Benachrichtigung wird das betreffende Terminalfenster sofort aktiviert, und sobald man zum Terminal zurückkehrt, verschwindet die Benachrichtigung automatisch. Wenn das Terminal bereits den Fokus hat, wird die Benachrichtigung gar nicht erst angezeigt, sodass der Arbeitsfluss nicht gestört wird.
Hauptfunktionen
- Intelligente Benachrichtigungen: Klick auf die Benachrichtigung → Terminal sofort aktivieren, beim Zurückkehren zum Terminal automatische Auflösung der Benachrichtigung, bei bereits vorhandenem Fokus keine Benachrichtigung
- 15 Hook-Ereignisse: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact usw.
- Multi-Monitor & Positionierung in 4 Ecken: mit Unterstützung für DPI-Skalierung
- Codex CLI-Unterstützung: Auch Ereignisse aus OpenAI Codex CLI werden als Benachrichtigungen empfangen
- Automatische Updates in der App: auf Basis von GitHub Releases
- Unterstützung für Koreanisch / Englisch
Installation
Auf der Releases-Seite kann man direkt das Installationsprogramm (Agent.Toast_*_x64-setup.exe) oder die portable ausführbare Datei (agent-toast.exe) herunterladen.
Verwendung
- Nach dem Start der App im Einstellungsfenster die gewünschten Hook-Ereignisse aktivieren und speichern
- Die Hooks werden automatisch in
~/.claude/settings.jsonregistriert - Im Claude-Code-Terminal
/hookseingeben und nach dem Aktualisieren ist alles angewendet
Tech-Stack
Rust + Tauri v2 + Vue 3 + TypeScript (MIT-Lizenz)
Funktionsweise
- Verwaltung einer einzelnen Instanz über Named Pipe — Beim ersten Start wird die App geöffnet, danach senden CLI-Aufrufe JSON über die Pipe und beenden sich sofort
- Mit der Win32 API werden Fokusänderungen in Echtzeit erkannt, damit Benachrichtigungen automatisch verschwinden können
- Durch das Durchsuchen des Prozessbaums wird die Genauigkeit der Terminalfenster-Erkennung über
--pidverbessert
Ich hoffe, dass dies Nutzern von Agenten wie Claude Code hilfreich ist. Feedback könnt ihr gern über GitHub Issues hinterlassen!
2 Kommentare
Ich habe per Hooks die Warcraft-3-Sounds zugeordnet.
"Jobs done"
„Jobs done“ ist echt witzig, haha. Falls ihr Agent Toast auch benutzt, könnt ihr per Klick auf die Benachrichtigung sofort ins Terminal wechseln, und wenn ihr das Terminal ohnehin schon offen habt, werden keine Benachrichtigungen angezeigt. In Kombination mit dem Warcraft-Sound ist das noch praktischer! Es wäre auch schön, wenn man benutzerdefinierte Sounds hinzufügen könnte.