Agent Toast — แจ้งเตือนอีเวนต์ของ Claude Code บน Windows

เมื่อปล่อยให้ Claude Code รันงานยาว ๆ ไว้แล้วไปทำอย่างอื่น ก็มักจะต้องคอยกลับมาเช็กที่เทอร์มินัลว่างานเสร็จหรือยังอยู่เรื่อย ๆ จึงขอเปิดตัวแอป Windows โอเพนซอร์สที่สร้างขึ้นมาเพื่อแก้ความไม่สะดวกนี้

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

เป็นแอปแบบไหน?

แอปนี้ใช้ระบบ Hook ของ Claude Code (หรือ Codex CLI) เพื่อแสดงการแจ้งเตือนแบบ Windows toast เมื่อเกิดอีเวนต์อย่างงานเสร็จ การขอสิทธิ์ หรือการรออินพุต

การแจ้งเตือนอัจฉริยะ — คลิกการแจ้งเตือนครั้งเดียวก็สลับไปยังหน้าต่างเทอร์มินัลนั้นได้ทันที และเมื่อกลับไปที่เทอร์มินัล การแจ้งเตือนจะหายไปอัตโนมัติ หากโฟกัสอยู่ที่เทอร์มินัลนั้นอยู่แล้ว ก็จะไม่แสดงการแจ้งเตือนเลย เพื่อไม่ให้รบกวนโฟลว์การทำงาน

ฟีเจอร์หลัก

• การแจ้งเตือนอัจฉริยะ: คลิกการแจ้งเตือน → เปิดใช้งานเทอร์มินัลทันที, เมื่อกลับสู่เทอร์มินัลการแจ้งเตือนจะหายอัตโนมัติ, หากมีโฟกัสอยู่แล้วจะข้ามการแจ้งเตือน
• Hook events 15 แบบ: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact เป็นต้น
• รองรับหลายจอและตำแหน่ง 4 มุม: รองรับการสเกล DPI
• รองรับ Codex CLI: รับอีเวนต์จาก OpenAI Codex CLI เป็นการแจ้งเตือนได้ด้วย
• อัปเดตอัตโนมัติในแอป: อ้างอิงจาก GitHub Releases
• รองรับภาษาเกาหลี / อังกฤษ

การติดตั้ง

สามารถดาวน์โหลดตัวติดตั้ง (Agent.Toast_*_x64-setup.exe) หรือไฟล์พกพา (agent-toast.exe) ได้ทันทีจากหน้า Releases

วิธีใช้งาน

1. เปิดแอป แล้วเปิดใช้งาน Hook event ที่ต้องการในหน้าตั้งค่า จากนั้นบันทึก
2. Hook จะถูกลงทะเบียนอัตโนมัติใน ~/.claude/settings.json
3. พิมพ์ /hooks ในเทอร์มินัลของ Claude Code แล้วรีเฟรช ก็จะใช้งานได้ทันที

เทคโนโลยีที่ใช้

Rust + Tauri v2 + Vue 3 + TypeScript (สัญญาอนุญาต MIT)

วิธีการทำงาน

• จัดการให้มีอินสแตนซ์เดียวด้วย Named Pipe — ตอนรันครั้งแรกจะเปิดแอปขึ้นมา และการเรียกจาก CLI หลังจากนั้นจะส่ง JSON ผ่าน pipe แล้วปิดตัวทันที
• ใช้ Win32 API ตรวจจับการเปลี่ยนโฟกัสแบบเรียลไทม์เพื่อให้การแจ้งเตือนหายอัตโนมัติ
• ปรับปรุงความแม่นยำในการตรวจหาหน้าต่างเทอร์มินัลจาก --pid ด้วยการสำรวจ process tree

หวังว่าจะเป็นประโยชน์กับผู้ใช้เอเจนต์อย่าง Claude Code เป็นต้น หากมีข้อเสนอแนะ สามารถฝากไว้ใน GitHub Issues ได้ตามสบาย!

[princox]

แมปเสียง Warcraft 3 ไว้ด้วย Hooks แล้ว
"Jobs done"

[hopoduck]

Jobs done สนุกดีนะ 555 ถ้าใช้ Agent Toast ด้วย เวลากดการแจ้งเตือนก็สลับไปที่เทอร์มินัลได้ทันที และถ้ากำลังดูเทอร์มินัลอยู่แล้วก็จะไม่ขึ้นการแจ้งเตือนด้วย ดังนั้นถ้าจับคู่กับเสียง Warcraft ก็น่าจะสะดวกขึ้นอีก! ถ้าเพิ่มการปรับแต่งเสียงได้ด้วยก็คงดีนะ