777genius/claude-notifications-go

해결하는 문제

Claude Code를 사용할 때 항상 터미널을 주시할 필요가 없습니다. 장시간 실행되는 AI 작업이 완료되었을 때, AI가 질문을 할 때, 또는 오류가 발생했을 때 스마트한 데스크톱 알림과 Webhook 알림을 통해 사용자에게 즉시 알립니다. 이를 통해 중요한 업데이트를 놓치지 않고 멀티태스킹이 가능합니다.

작동 방식

이 프로젝트는 Claude Code용 플러그인으로, AI의 라이프사이클(예: PreToolUse, Stop 훅 등)에 연결됩니다. AI 상태를 모니터링하여 작업 완료, 코드 리뷰, API 오류와 같은 이벤트를 감지하고, 네이티브 OS 데스크톱 알림 또는 설정된 Webhook을 통해 알림을 발송합니다. 오디오 재생, 창 포커스, 외부 API 호출 등의 중간 처리는 Go 기반 바이너리가 담당합니다.

대상 사용자

장시간 실행 작업이나 여러 터미널 창에서 복잡한 워크플로우를 수행하는 개발자 중, 백그라운드에서 AI 진행 상황을 알림으로 받고 싶은 사용자.

주요 기능

• 클릭 시 포커스: 알림을 클릭하면 Ghostty, VS Code, iTerm2 등 다양한 터미널과 tmux, zellij 등의 멀티플렉서에서 특정 프로젝트 창과 탭을 자동으로 포커스합니다.
• 다중 채널 알림: 네이티브 데스크톱 알림과 Slack, Discord, Telegram, Microsoft Teams 등 다양한 Webhook을 지원합니다.
• 문맥 인식: 알림 제목에 현재 Git 브랜치를 표시하며, 사용자가 이미 활성 터미널에 포커스되어 있으면 알림을 억제합니다.
• 사용자 정의 오디오: MP3, WAV, FLAC 등 다양한 오디오 형식을 지원하며, 볼륨 조절과 특정 오디오 장치로 사운드를 라우팅할 수 있습니다.
• 크로스 플랫폼: macOS, Linux, Windows 10+에 대해 네이티브 지원.