777genius/agent-notifications

해결하는 문제

Agent Notifications는 Claude Code 및 Codex CLI와 같은 AI 에이전트의 진행 상황을 지속적으로 터미널을 모니터링하지 않아도 알 수 있도록 해줍니다. 특정 에이전트 이벤트(작업 완료, API 오류, 사용자 입력 요청 등)가 발생할 때 시스템 알림을 전송하고, 사운드를 재생하며, 웹훅을 트리거함으로써 "눈먼 기다림" 문제를 해결합니다.

작동 방식

이 프로젝트는 에이전트의 훅 시스템과 통합되는 크로스플랫폼 플러그인입니다. Stop 또는 PreToolUse 훅과 같은 특정 트리거를 모니터링하고, 이러한 이벤트를 알림으로 매핑합니다. 예를 들어, 상태 머신과 텍스트 히ュ리스틱을 기반으로 작업 완료 또는 사용자에게 질문이 필요한 상황을 감지할 수 있습니다. 또한 "클릭 시 포커스" 기능을 포함하여, macOS의 AX API나 Linux의 D-Bus와 같은 플랫폼 전용 API를 사용해 알림을 클릭했을 때 올바른 터미널 창, 탭, 패널을 자동으로 포커스로 되돌립니다.

대상 사용자

AI 에이전트가 백그라운드에서 복잡하고 오랜 시간이 걸리는 작업을 수행하는 동안 멀티태스킹을 통해 생산성을 높이고 싶은 Claude Code 또는 Codex CLI를 사용하는 개발자.

주요 기능

• 다중 에이전트 지원: Claude Code와 Codex CLI 모두 호환.
• 터미널 깊은 통합: Ghostty, VS Code, iTerm2, Warp, kitty, WezTerm 등 다양한 터미널과 tmux, zellij와 같은 멀티플렉서에 대한 클릭 시 포커스 지원.
• 풍부한 알림: 사운드 알림(MP3/WAV/FLAC/OGG/AIFF) 및 알림 제목에 Git 브랜치 표시.
• 광범위한 웹훅 통합: Slack, Discord, Telegram, Microsoft Teams, ntfy.sh, PagerDuty 등 지원하며, 내장된 재시도 및 레이트 제한 기능 제공.
• 크로스플랫폼: macOS, Linux, Windows 10+에 네이티브 지원.