Agent Toast — đưa sự kiện Claude Code thành thông báo Windows

Khi chạy các tác vụ dài bằng Claude Code rồi tranh thủ làm việc khác, bạn sẽ cứ phải liên tục kiểm tra terminal xem tác vụ đã xong chưa. Tôi công bố một ứng dụng Windows mã nguồn mở được tạo ra để giải quyết sự bất tiện đó.

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

Đây là ứng dụng gì?

Bằng cách sử dụng hệ thống Hook của Claude Code (hoặc Codex CLI), ứng dụng sẽ hiển thị thông báo toast trên Windows khi xảy ra các sự kiện như hoàn tất tác vụ, yêu cầu cấp quyền, hoặc chờ nhập liệu.

Thông báo thông minh — chỉ với một lần nhấp vào thông báo, cửa sổ terminal tương ứng sẽ được kích hoạt ngay; khi quay lại terminal, thông báo sẽ tự động biến mất. Nếu terminal đã đang được focus thì ứng dụng sẽ không hiển thị thông báo ngay từ đầu, nên không làm gián đoạn luồng làm việc.

Tính năng chính

• Thông báo thông minh: nhấp thông báo → kích hoạt terminal ngay, khi quay lại terminal thì thông báo tự biến mất, nếu đang focus sẵn thì bỏ qua thông báo
• 15 sự kiện Hook: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact, v.v.
• Đa màn hình & vị trí 4 góc: hỗ trợ DPI scaling
• Hỗ trợ Codex CLI: cũng nhận sự kiện từ OpenAI Codex CLI dưới dạng thông báo
• Tự động cập nhật trong ứng dụng: dựa trên GitHub Releases
• Hỗ trợ tiếng Hàn / tiếng Anh

Cài đặt

Bạn có thể tải trực tiếp trình cài đặt (Agent.Toast_*_x64-setup.exe) hoặc tệp thực thi bản portable (agent-toast.exe) từ trang Releases.

Cách dùng

1. Sau khi chạy ứng dụng, hãy bật các sự kiện hook mong muốn trong cửa sổ cài đặt rồi lưu lại
2. Hook sẽ được đăng ký tự động vào ~/.claude/settings.json
3. Trong terminal Claude Code, nhập /hooks rồi làm mới để áp dụng xong

Tech stack

Rust + Tauri v2 + Vue 3 + TypeScript (giấy phép MIT)

Cách hoạt động

• Quản lý single instance bằng Named Pipe — ở lần chạy đầu sẽ mở ứng dụng, các lần gọi từ CLI sau đó sẽ gửi JSON qua pipe rồi thoát ngay
• Dùng Win32 API để phát hiện thay đổi focus theo thời gian thực và tự động xử lý việc ẩn thông báo
• Dò cây tiến trình để cải thiện độ chính xác khi phát hiện cửa sổ terminal từ --pid

Hy vọng ứng dụng này sẽ hữu ích cho người dùng agent như Claude Code. Hãy thoải mái để lại phản hồi qua GitHub Issues!

[princox]

Tôi đã ánh xạ âm thanh Warcraft 3 bằng Hooks.
"Jobs done"

[hopoduck]

Jobs done nghe vui phết haha. Nếu bạn dùng thêm Agent Toast thì còn có thể bấm vào thông báo để chuyển ngay sang terminal, và khi đã đang nhìn terminal rồi thì nó cũng sẽ không hiện thông báo nữa, nên nếu kết hợp với âm thanh Warcraft sẽ còn tiện hơn đấy! Nếu thêm cả tùy chỉnh âm thanh thì cũng hay nữa.