peon-ping (Windows)
워크래프트 III 피온 음성으로 Claude Code 이벤트를 알려주는 Hooks 확장.
- 출처: https://github.com/Aherys/peon-ping-windows
- 원본 (macOS): https://github.com/PeonPing/peon-ping
- 라이선스: MIT
요구사항
- Windows 10+
- PowerShell 5.1+
- Claude Code (hooks 지원 버전)
설치
git clone https://github.com/Aherys/peon-ping-windows.git
cd peon-ping-windows
powershell -ExecutionPolicy Bypass -File download-sounds.ps1
powershell -ExecutionPolicy Bypass -File install.ps1
설치 후 자동으로:
- 111개 사운드 파일을
~/.claude/hooks/peon-ping/packs/에 다운로드 peon.ps1+config.json을~/.claude/hooks/peon-ping/에 배치~/.claude/settings.json에 hooks 등록- PowerShell 프로필에
peon명령어 추가
주의: 백슬래시 이스케이프 문제
install.ps1이 settings.json에 경로를 쓸 때 백슬래시가 과도하게 이스케이프될 수 있음.
설치 후 반드시 확인하고, 아래처럼 수정:
# 잘못된 예 (\\\\\\\\)
"C:\\\\\\\\Users\\\\\\\\smart\\\\\\\\.claude\\\\\\\\hooks\\\\\\\\peon-ping\\\\\\\\peon.ps1"
# 올바른 예 (\\)
"C:\\Users\\smart\\.claude\\hooks\\peon-ping\\peon.ps1"
참고 템플릿: settings-hooks-template.json
이벤트 → 음성 매핑
| 이벤트 | 트리거 | 음성 |
|---|---|---|
| SessionStart | 세션 시작 | "Ready to work?" |
| UserPromptSubmit | 프롬프트 전송 | "Work, work." |
| Stop | 작업 완료 | "Something need doing?" |
| Notification (permission) | 권한 요청 | "What you want?" + 토스트 |
| Notification (idle) | 유휴 | 토스트 알림 |
| Annoyed | 빠른 연속 프롬프트 | "Me busy, leave me alone!" |
Windows 전용 기능
- 토스트 알림: WinRT API로 포커스 상관없이 알림 표시
- 탭 타이틀: 터미널 탭에 프로젝트 상태 표시 (예:
● project: done) - 작업표시줄 깜빡임: 권한 요청/유휴 시 아이콘 깜빡임
사운드 팩 (7종)
| 팩 | 출처 | 사운드 수 |
|---|---|---|
peon (기본) | 워크래프트 III 오크 일꾼 | 19 |
peon_fr | 프랑스어 피온 | 17 |
peasant | 워크래프트 III 인간 농부 | 20 |
peasant_fr | 프랑스어 농부 | 19 |
ra2_soviet_engineer | 레드얼럿 2 소련 기술자 | 8 |
sc_battlecruiser | 스타크래프트 배틀크루저 | 15 |
sc_kerrigan | 스타크래프트 케리건 | 14 |
CLI 명령어
peon --status # 상태 확인
peon --pause # 음소거
peon --resume # 음소거 해제
peon --toggle # 토글
제거
& "$env:USERPROFILE\.claude\hooks\peon-ping\uninstall.ps1"