Warcraft III 일꾼 음성 알림으로 Claude Code 작업 상태를 알려주는 PeonPing

• AI 코딩 에이전트의 진행 상태를 음성으로 알려주는 도구로, Warcraft III의 일꾼(피온) 음성을 활용해 작업 완료나 입력 요청을 알림
• Claude Code, Codex, Cursor, OpenCode 등 주요 IDE와 연동되며, 터미널을 계속 지켜볼 필요 없이 상태를 청각적으로 인식 가능
• 40개 이상 사운드 팩을 지원하며 Warcraft, StarCraft, Portal, Zelda 등 다양한 게임 캐릭터 음성을 포함
• macOS, Linux, WSL2 환경에서 동작하며, Homebrew 또는 curl 명령어로 간단히 설치 가능
• 개발 흐름을 유지하면서도 작업 완료·오류·입력 요청 등 이벤트를 즉시 인지할 수 있는 생산성 향상 도구

개요

• PeonPing은 Claude Code와 Codex용 음성 알림 시스템으로, AI 코딩 에이전트가 작업을 완료하거나 입력을 요청할 때 게임 캐릭터 음성으로 알려줌
  • Warcraft III의 피온(Orc Peon) 음성을 기본으로 사용
  • StarCraft, Portal, Zelda 등 다양한 프랜차이즈의 캐릭터 음성 팩 제공
• 사용자는 터미널을 계속 주시하지 않아도 음성 피드백으로 작업 상태를 즉시 파악 가능

주요 기능

• Coding Event Sound Pack Specification (CESP) 표준을 구현하여, IDE 이벤트를 표준화된 사운드 카테고리로 매핑
  • session.start, task.complete, input.required, user.spam 등 이벤트별 음성 출력
  • 예: “Ready to work?”, “Work, work.”, “Something need doing?” 등
• 터미널 탭 제목 및 데스크톱 알림 기능을 함께 제공
  • 터미널이 비활성화된 상태에서도 시각적 알림 표시
• CLI 제어 명령어 지원
  • peon toggle, peon pause, peon packs use <name> 등으로 음성·알림 제어
  • 탭 자동완성 기능 지원

설치 및 환경

• 설치 방법
  • macOS 및 Linux에서 brew install PeonPing/tap/peon-ping 또는 curl -fsSL ... | bash 명령으로 설치
  • 설치 시 10개의 영어 음성 팩이 기본 포함
  • --all 옵션으로 모든 언어·프랜차이즈 팩 설치 가능
• 지원 환경
  • macOS(afplay), Linux(paplay, ffplay, mpv, aplay), WSL2(PowerShell MediaPlayer)
  • Claude Code, Codex, Cursor, OpenCode 등 IDE와 연동
  • Python3 필요

설정 및 사용자 제어

• 설정 파일은 ~/.claude/hooks/peon-ping/config.json에 저장
  • 볼륨 조절(0.0–1.0) , 알림 카테고리별 활성화, 데스크톱 알림 on/off 가능
  • silent_window_seconds 옵션으로 짧은 작업의 알림 억제
  • pack_rotation 으로 세션마다 무작위 음성 팩 순환 가능
• Claude Code 내 /peon-ping-toggle 명령 또는 CLI로 즉시 음소거·복원 가능

사운드 팩 구성

• 40개 이상 팩 제공, 대표 팩 예시:
  • peon: Warcraft III 오크 일꾼
  • peasant: 인간 일꾼
  • glados: Portal의 GLaDOS
  • sc_kerrigan: StarCraft의 Sarah Kerrigan
  • dota2_axe, duke_nukem, tf2_engineer, hd2_helldiver 등
• 모든 팩은 openpeon.com/packs에서 미리 듣기 가능
• 사용자는 peon packs use <name> 명령으로 팩 전환 가능

작동 방식

• peon.sh 스크립트가 Claude Code의 SessionStart, UserPromptSubmit, Stop, Notification, PermissionRequest 이벤트를 감지
  • 각 이벤트를 CESP 카테고리에 매핑 후 무작위 음성 재생
  • 중복 재생 방지 및 터미널 탭 제목 업데이트 수행
• 사운드 팩은 OpenPeon registry에서 다운로드
  • 공식 팩은 PeonPing/og-packs에 호스팅
  • 음성 파일은 각 게임 퍼블리셔의 자산이며, 개인 알림 용도로 공정 사용(fair use) 범위 내 배포

기타 정보

• MIT 라이선스로 공개
• 1.2k GitHub stars, 97 forks 기록
• 공식 웹사이트: peonping.com
• 관련 프로젝트: openpeon.com, PeonPing/registry

요약: PeonPing은 AI 코딩 환경에서 작업 흐름을 방해하지 않으면서도, 게임 캐릭터 음성으로 코딩 이벤트를 실시간 알림하는 오픈소스 도구로, 개발자의 몰입도와 효율을 높이는 유쾌한 접근을 제공함.