Show GN: Agent Toast — Claude Code 이벤트를 Windows 알림으로
(github.com/hopoduck)Claude Code로 긴 작업을 돌려두고 다른 일을 하다 보면, 작업이 끝났는지 계속 터미널을 확인하게 됩니다. 그 불편함을 해소하려고 만든 오픈소스 Windows 앱을 공개합니다.
GitHub: https://github.com/hopoduck/agent-toast
어떤 앱인가요?
Claude Code(또는 Codex CLI)의 Hook 시스템을 이용해, 작업 완료·권한 요청·입력 대기 같은 이벤트가 발생하면 Windows 토스트 알림을 띄워줍니다.
스마트 알림 — 알림 클릭 한 번으로 해당 터미널 창이 즉시 활성화되고, 터미널로 돌아가면 알림이 자동으로 사라집니다. 이미 터미널에 포커스가 있으면 알림 자체를 띄우지 않아, 작업 흐름을 방해하지 않습니다.
주요 기능
- 스마트 알림: 알림 클릭 → 터미널 즉시 활성화, 터미널 복귀 시 알림 자동 소멸, 이미 포커스 중이면 알림 생략
- 15가지 Hook 이벤트: Stop, PermissionRequest, SessionStart/End, SubagentStart/Stop, Notification, PreToolUse/PostToolUse, PreCompact 등
- 멀티 모니터 & 4코너 위치: DPI 스케일 대응
- Codex CLI 지원: OpenAI Codex CLI 이벤트도 알림으로 수신
- 인앱 자동 업데이트: GitHub Releases 기반
- 한국어 / 영어 지원
설치
Releases 페이지에서 설치 프로그램(Agent.Toast_*_x64-setup.exe) 또는 포터블 실행 파일(agent-toast.exe)을 바로 받을 수 있습니다.
사용법
- 앱 실행 후 설정 창에서 원하는 훅 이벤트를 활성화하고 저장
-
~/.claude/settings.json에 훅이 자동 등록됨 - Claude Code 터미널에서
/hooks입력 후 새로고침하면 적용 완료
기술 스택
Rust + Tauri v2 + Vue 3 + TypeScript (MIT 라이선스)
작동 방식
- Named Pipe로 단일 인스턴스 관리 — 최초 실행 시 앱을 띄우고, 이후 CLI 호출은 파이프로 JSON 전송 후 즉시 종료
- Win32 API로 포커스 변화를 실시간 감지하여 알림 자동 소멸 처리
- 프로세스 트리 탐색으로
--pid에서 터미널 창 탐지 정확도 개선
Claude Code 등 에이전트 사용자에게 도움이 되길 바랍니다. 피드백은 GitHub Issues로 편하게 남겨주세요!