프로젝트 소개

Agent Notifications는 Claude Code와 Codex CLI를 위한 스마트 데스크톱 알림, 오디오 경고, 클릭 시 포커스 통합을 제공하는 크로스 플랫폼 도구입니다. 주요 기능: - **알림**: 작업 완료, 코드 리뷰 완료, 질문 발생, 계획 준비 완료, 세션 한도 도달, API 오류 발생 시 사용자에게 알립니다. Codex 권한 요청과 선택적 서브에이전트 알림을 지원합니다. - **클릭 시 포커스**: 알림을 클릭하면 사용자가 시작한 터미널이나 편집기로 빠르게 돌아가며, macOS, Linux, Windows 전반에서 Ghostty, iTerm2, Warp, tmux, kitty, WezTerm, VS Code, JetBrains IDE의 정확한 탭/패널 지정을 지원합니다. - **오디오 및 사용자 지정**: 내장 또는 사용자 지정 MP3, WAV, FLAC, OGG, AIFF 사운드를 제공하며 볼륨 조절, 미리 듣기, 오디오 장치 선택을 지원합니다. - **노이즈 감소**: 포커스 인식 전달, 선택적 지연, 중복 질문 억제, 상태/브랜치/폴더 필터링, macOS 방해 금지 모드 및 디스플레이 절전 상태와의 통합을 제공합니다. - **웹훅**: Slack, Discord, Telegram, Lark/Feishu 및 사용자 지정 엔드포인트(Teams, ntfy, PagerDuty, Zapier, n8n, Make 포함)에 대한 아웃바운드 통합을 지원하며 내장 재시도, 속도 제한, 회로 차단기를 갖추고 있습니다. - **크로스 플랫폼**: 외부 의존성 없이 순수 Go로 작성되었습니다. 초기 설정 후 오프라인에서 작동합니다. macOS(Intel/Apple Silicon), Linux(x64/ARM64), Windows 10+(x64)를 지원합니다. 설치 및 구성: 이 도구는 안내형 셸 설치 프로그램, 수동 Claude Code 플러그인 명령 또는 수동 Codex 등록을 통해 설치할 수 있습니다. 에이전트별 재정의가 가능한 공유 구성 파일을 사용하며, 대화형 설정 마법사 또는 `agent-notifications` CLI로 관리합니다. 구성은 사용자 지정 사운드, 웹훅 프리셋, 억제 필터, 상태별 전달 설정을 지원합니다.