# Show GN: Agent Toast — Claude Code 이벤트를 Windows 알림으로

> Clean Markdown view of GeekNews topic #26812. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=26812](https://news.hada.io/topic?id=26812)
- GeekNews Markdown: [https://news.hada.io/topic/26812.md](https://news.hada.io/topic/26812.md)
- Type: show
- Author: [hopoduck](https://news.hada.io/@hopoduck)
- Published: 2026-02-19T17:47:38+09:00
- Updated: 2026-02-19T17:47:38+09:00
- Original source: [github.com/hopoduck](https://github.com/hopoduck/agent-toast)
- Points: 5
- Comments: 2

## Summary

**Agent Toast**는 Claude Code나 Codex CLI의 **Hook 이벤트를 Windows 토스트 알림으로 전환**해주는 오픈소스 앱입니다. 긴 코드 실행 중에도 터미널을 계속 확인할 필요 없이, 작업 완료나 권한 요청 등의 상황을 실시간으로 받아볼 수 있습니다. 알림을 클릭하면 해당 터미널이 즉시 활성화되고, 포커스가 돌아오면 자동으로 사라져 흐름이 끊기지 않습니다. Rust와 Tauri 기반으로 제작되어 가볍게 동작하며, GitHub Releases에서 바로 설치할 수 있습니다.

## Topic Body

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`)을 바로 받을 수 있습니다.  
  
##### 사용법  
  
1. 앱 실행 후 설정 창에서 원하는 훅 이벤트를 활성화하고 저장  
2. `~/.claude/settings.json`에 훅이 자동 등록됨  
3. Claude Code 터미널에서 `/hooks` 입력 후 새로고침하면 적용 완료  
  
##### 기술 스택  
  
**Rust + Tauri v2 + Vue 3 + TypeScript** (MIT 라이선스)  
  
##### 작동 방식  
  
- Named Pipe로 단일 인스턴스 관리 — 최초 실행 시 앱을 띄우고, 이후 CLI 호출은 파이프로 JSON 전송 후 즉시 종료  
- Win32 API로 포커스 변화를 실시간 감지하여 알림 자동 소멸 처리  
- 프로세스 트리 탐색으로 `--pid`에서 터미널 창 탐지 정확도 개선  
  
Claude Code 등 에이전트 사용자에게 도움이 되길 바랍니다. 피드백은 GitHub Issues로 편하게 남겨주세요!

## Comments



### Comment 51415

- Author: princox
- Created: 2026-02-19T17:49:38+09:00
- Points: 1

Hooks로 워크래프트3 소리 맵핑해놨습니다.  
"Jobs done"

### Comment 51418

- Author: hopoduck
- Created: 2026-02-19T18:22:38+09:00
- Points: 1
- Parent comment: 51415
- Depth: 1

Jobs done 재밌네요 ㅋㅋㅋ 혹시 Agent Toast도 같이 쓰시면 알림 클릭으로 터미널 즉시 전환도 되고, 이미 터미널 보고 있을 땐 알림 안 뜨게 해주니까 워크래프트 사운드랑 조합하면 더 편하실 겁니다! 사운드 커스텀도 추가하면 좋겠네요.