Agent Toast — Claude Code इवेंट्स के लिए Windows notifications

Claude Code पर लंबा काम चलाकर जब आप कोई और काम करने लगते हैं, तो बार-बार टर्मिनल देखकर यह जांचना पड़ता है कि काम खत्म हुआ या नहीं। इसी असुविधा को दूर करने के लिए बनाया गया यह open source Windows app अब सार्वजनिक है.

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

यह किस तरह का app है?

Claude Code (या Codex CLI) के Hook system का उपयोग करके, जब काम पूरा होना, permission request, या input wait जैसे इवेंट होते हैं, तब यह Windows toast notification दिखाता है.

Smart notifications — notification पर एक बार क्लिक करते ही संबंधित terminal window तुरंत active हो जाती है, और टर्मिनल पर लौटते ही notification अपने-आप गायब हो जाता है। अगर फोकस पहले से ही टर्मिनल पर हो, तो notification दिखाया ही नहीं जाता, ताकि काम का flow बाधित न हो.

मुख्य फीचर्स

• Smart notifications: notification पर क्लिक → terminal तुरंत active, terminal पर लौटते ही notification अपने-आप बंद, पहले से focus में होने पर notification छोड़ा जाता है
• 15 Hook events: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact आदि
• Multi-monitor & 4-corner positioning: DPI scaling support
• Codex CLI support: OpenAI Codex CLI इवेंट्स भी notification के रूप में प्राप्त
• In-app automatic updates: GitHub Releases आधारित
• कोरियन / अंग्रेज़ी support

इंस्टॉलेशन

Releases page से installer (Agent.Toast_*_x64-setup.exe) या portable executable (agent-toast.exe) सीधे डाउनलोड किया जा सकता है.

उपयोग

1. app चलाने के बाद settings window में इच्छित hook events को enable करके save करें
2. ~/.claude/settings.json में hooks अपने-आप register हो जाते हैं
3. Claude Code terminal में /hooks दर्ज करके refresh करें, तो सेटअप लागू हो जाता है

टेक स्टैक

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

यह कैसे काम करता है

• Named Pipe से single instance management — पहली बार चलने पर app शुरू होता है, और बाद के CLI calls pipe के ज़रिए JSON भेजकर तुरंत बंद हो जाते हैं
• Win32 API से focus changes का real-time पता लगाकर notification auto-dismiss किया जाता है
• process tree traversal से --pid के आधार पर terminal window detection की सटीकता बेहतर की गई है

उम्मीद है कि यह Claude Code जैसे agent users के लिए उपयोगी होगा। फ़ीडबैक GitHub Issues में बेझिझक छोड़ें!

[princox]

Hooks से Warcraft 3 की sounds मैप कर रखी हैं.
"Jobs done"

[hopoduck]

Jobs done काफ़ी मज़ेदार है hahaha अगर आप Agent Toast भी साथ में इस्तेमाल करें, तो नोटिफिकेशन पर क्लिक करके तुरंत टर्मिनल पर जा सकते हैं, और अगर आप पहले से ही टर्मिनल देख रहे हों तो यह नोटिफिकेशन नहीं दिखाता, इसलिए Warcraft साउंड के साथ मिलाकर इस्तेमाल करें तो और भी सुविधाजनक रहेगा! अगर साउंड कस्टमाइज़ेशन भी जोड़ दिया जाए तो अच्छा होगा।