[Agent Toast] Claude Code 작업 끝나면 알림 보내주는 Windows 앱 만들었습니다

안녕하세요! Windows에서 Claude Code 쓰시는 분들께 도움이 될 것 같아 만든 사이드 프로젝트를 공유합니다.

만들게 된 계기

Claude Code로 긴 작업을 돌려놓고 유튜브 보거나 다른 일을 하다 보면, 작업이 끝났는지 확인하려고 자꾸 터미널을 왔다 갔다 하게 되더라고요. "작업 끝나면 알림이 오면 좋겠다"는 생각에 직접 만들어봤습니다.

Agent Toast가 뭔가요?

Claude Code의 Hook 시스템을 이용해서, 작업 완료 / 권한 요청 / 입력 대기 같은 이벤트가 발생하면 Windows 토스트 알림을 띄워주는 앱입니다.

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

주요 기능

• 스마트 알림 — 알림 클릭하면 해당 터미널 창이 바로 활성화되고, 터미널로 돌아가면 알림이 자동으로 사라집니다. 이미 터미널에 포커스가 있으면 알림을 안 띄워서 작업 흐름을 방해하지 않아요.

• 15가지 Hook 이벤트 — 작업 완료, 권한 요청, 입력 대기, 세션 시작/종료, 서브에이전트 시작/종료 등 거의 모든 이벤트를 지원합니다.

• 멀티 모니터 & 4코너 위치 — 원하는 모니터의 원하는 코너에 알림을 띄울 수 있고, DPI 스케일도 대응합니다.

• 알림 사운드 — 시스템 알림음으로 놓치지 않게 해줍니다 (설정에서 on/off 가능).

• Codex CLI 지원 — OpenAI Codex CLI 이벤트도 받을 수 있습니다.

• 한국어 / 영어 지원

설치 & 사용법

1. [Releases 페이지](https://github.com/hopoduck/agent-toast/releases/latest)에서 설치 프로그램 또는 포터블 exe를 다운로드

2. 앱 실행 후 설정 창에서 원하는 훅 이벤트를 활성화하고 저장

3. ~/.claude/settings.json에 훅이 자동 등록됩니다

4. Claude Code 터미널에서 /hooks 입력 후 새로고침하면 끝!

기술 스택

Rust + Tauri v2 (백엔드) + Vue 3 + TypeScript (프론트엔드)

Tauri를 선택한 이유는 Electron보다 훨씬 가볍고, Rust로 Windows 네이티브 API를 직접 다룰 수 있어서였습니다.

개발하면서 재밌었던 점

• Windows에서 알림을 클릭했을 때 해당 터미널을 정확히 찾아서 포커스를 주는 게 생각보다 까다로웠는데, 프로세스 트리를 타고 올라가면서 터미널 창을 찾고, 프로젝트 폴더명으로 윈도우 타이틀을 매칭해서 여러 터미널 중 정확한 창을 골라내는 방식으로 해결했습니다.

• 터미널에 포커스가 돌아오면 알림이 자동으로 사라지는 기능은 Win32 API의 포커스 이벤트를 실시간으로 감지해서 구현했습니다.

앞으로 할 일

• 다양한 OS 지원 (현재는 Windows만 지원합니다)

• 더 다양한 AI 코딩 에이전트 지원

MIT 라이선스 오픈소스이고, 피드백이나 버그 리포트는 [GitHub Issues](https://github.com/hopoduck/agent-toast/issues)로 편하게 남겨주세요! 감사합니다.