# PeonPing - Warcraft III 일꾼 음성으로 Claude Code 작업 상태 알려주기

> Clean Markdown view of GeekNews topic #26645. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=26645](https://news.hada.io/topic?id=26645)
- GeekNews Markdown: [https://news.hada.io/topic/26645.md](https://news.hada.io/topic/26645.md)
- Type: GN+
- Author: [neo](https://news.hada.io/@neo)
- Published: 2026-02-13T09:42:31+09:00
- Updated: 2026-02-13T09:42:31+09:00
- Original source: [github.com/tonyyont](https://github.com/tonyyont/peon-ping)
- Points: 37
- Comments: 14

## Summary

AI 코딩 에이전트의 상태를 **워크래프트·스타크래프트 등 게임 캐릭터 음성**으로 알려주는 도구입니다. Claude Code, Codex, Cursor 등 주요 IDE와 연동되어 작업 완료나 입력 요청을 소리로 전달하며, 여러 에이전트한테 일시키기도 편하고 터미널을 계속 주시하지 않아도 됩니다. 40여 종의 사운드 팩을 지원합니다. Codex 사용자는 댓글에 있는 **Codex-Peon** 을 설치하면 설정도 간단합니다. 웃기긴 한데 굉장히 편리합니다. 꼭 써보세요. **“Work, work.”**

## Topic Body

- 워크래프트/스타크래프트/젤다 등의 음성을 활용해 **AI 코딩 에이전트의 작업 완료나 입력 요청을 음성으로 알려주는 도구**  
- **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 ` 등으로 음성·알림 제어  
  - 탭 자동완성 기능 지원  
  
### 설치 및 환경  
- **설치 방법**  
  - 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](https://openpeon.com/packs)에서 미리 듣기 가능  
- 사용자는 `peon packs use ` 명령으로 팩 전환 가능  
  
### 작동 방식  
- `peon.sh` 스크립트가 Claude Code의 **SessionStart, UserPromptSubmit, Stop, Notification, PermissionRequest** 이벤트를 감지  
  - 각 이벤트를 CESP 카테고리에 매핑 후 무작위 음성 재생  
  - 중복 재생 방지 및 터미널 탭 제목 업데이트 수행  
- 사운드 팩은 [OpenPeon registry](https://github.com/PeonPing/registry)에서 다운로드  
  - 공식 팩은 [PeonPing/og-packs](https://github.com/PeonPing/og-packs)에 호스팅  
  - 음성 파일은 각 게임 퍼블리셔의 자산이며, 개인 알림 용도로 **공정 사용(fair use)** 범위 내 배포  
  
### 기타 정보  
- **MIT 라이선스**로 공개  
- 공식 웹사이트: [peonping.com](https://peonping.com/)  
- 관련 프로젝트: [openpeon.com](https://openpeon.com/), [PeonPing/registry](https://github.com/PeonPing/registry)

## Comments



### Comment 53336

- Author: curioe
- Created: 2026-03-19T09:58:59+09:00
- Points: 1

좀 늦었지만 저희집 고양이 소리 녹음해서 바꿨어요. ㅎㅎㅎ  
작업 하나 끝났을 때 야옹 하고 불러주니 매우 흐뭇해요.

### Comment 51242

- Author: yangeok
- Created: 2026-02-16T12:06:00+09:00
- Points: 1

ㅋㅋㅋㅋ ready to work

### Comment 51128

- Author: kaydash
- Created: 2026-02-13T20:08:20+09:00
- Points: 1

ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ

### Comment 51126

- Author: tesla52
- Created: 2026-02-13T19:19:14+09:00
- Points: 1

사운드팩 리스트가 너무 마음에드네요 근본이 느껴집니다

### Comment 51119

- Author: qlghwp123
- Created: 2026-02-13T16:05:14+09:00
- Points: 1

ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ  
너무 재밌겠는데요 ?

### Comment 51113

- Author: ifmkl
- Created: 2026-02-13T14:50:09+09:00
- Points: 1

이거지!

### Comment 51112

- Author: edunga1
- Created: 2026-02-13T14:12:35+09:00
- Points: 1

Job's Done! 당장 해봐야겠다 ㅋㅋㅋ

### Comment 51111

- Author: t7vonn
- Created: 2026-02-13T13:58:24+09:00
- Points: 1

ㅋㅋㅋ 너무 재밌습니다

### Comment 51110

- Author: ryj0902
- Created: 2026-02-13T13:37:15+09:00
- Points: 1

Ready to work? Work, work.

### Comment 51106

- Author: winterjung
- Created: 2026-02-13T12:28:36+09:00
- Points: 1

좀 더 간단히 하시고 싶으면 https://www.wowhead.com/sounds/name:peon 사이트에서 필요한 사운드만 다운받아 아래처럼 `~/.claude/settings.json`을 적어두시면 됩니다.  
  
```  
{  
  "hooks": {  
    "SessionStart": [  
      {"hooks": [{"type": "command", "command": "afplay /Users/name/.claude/hooks/PeonReady1.ogg"}]}  
    ],  
    "UserPromptSubmit": [  
      {"hooks": [{"type": "command", "command": "afplay /Users/name/.claude/hooks/PeonYes3.ogg"}]}  
    ],  
    "Notification": [  
      {"hooks": [{"type": "command", "command": "afplay /Users/name/.claude/hooks/PeonWhat3.ogg"}]}  
    ],  
    "Stop": [  
      {"hooks": [{"type": "command", "command": "afplay /Users/name/.claude/hooks/PeonBuildingComplete1.ogg"}]}  
    ]  
  }  
}  
```

### Comment 51105

- Author: xguru
- Created: 2026-02-13T12:20:47+09:00
- Points: 1

Codex 를 주로 쓴다면 https://github.com/mrdavey/codex-peon 요게 설정이 더 편합니다

### Comment 51102

- Author: mammal
- Created: 2026-02-13T10:51:14+09:00
- Points: 1

최근 본 프로젝트중 최고

### Comment 51127

- Author: cysl0
- Created: 2026-02-13T19:29:15+09:00
- Points: 1
- Parent comment: 51102
- Depth: 1

ㅋㅋㅋㅋㅋㅋㅋ

### Comment 51094

- Author: neo
- Created: 2026-02-13T09:42:31+09:00
- Points: 1

###### [Hacker News 의견들](https://news.ycombinator.com/item?id=46985151) 
- 드디어 “Claude, 또 하나의 쓸모없는 SaaS 만들어줘” 같은 게 아니라 **LLM으로 진짜 유용한 작업**을 하는 사람이 나왔음  
  예언대로 진짜 차별화 포인트는 **창의성**, 코딩 실력이 아님
  - 동의함. 이제 누군가 **Majel Barrett**의 목소리를 완벽히 재현해줘서 컴퓨터가 진짜 미래처럼 들리게 되길 기다리고 있음  
    이미 10년 전쯤 가능했을 텐데, 고품질 오디오 샘플들이 저작권자와 상업적 이해관계 사이에 묶여버려서 프로젝트가 지연된 게 아쉬움
  - 재밌긴 하지만, 무작위 vibe-coded `.sh` 스크립트에서 **공급망 공격**이나 악성 코드에 주의해야 함  
    예를 들어 다른 스크립트를 다운로드해 실행하거나, `~/.bashrc`를 수정하고, 원격 JSON을 파싱해 파일을 받아오는 식임
  - **창의성**이 곧 왕이 될 것 같은 흐름임
  - 맞음. peon 알림 기능이 완벽한 예시임. 작지만 도구를 더 쓰고 싶게 만드는 요소임  
    요즘 좋은 소프트웨어는 “만드는 사람이 즐거웠다”는 느낌이 남. 단순히 작동하는 도구와 “이거 재밌네” 하는 도구의 차이를 바로 느낄 수 있음

- 이 프로젝트를 보니 **Warcraft 1**이 떠올랐음. 같은 유닛을 계속 클릭하면 점점 짜증 섞인 반응을 하는데, 인간 병사가 “왜 계속 만지는 거야?”라고 말하던 게 최고였음  
  [관련 영상](https://www.youtube.com/watch?v=jaZyZZtwdzQ)
  - 사운드 설정 프로그램에서도 같은 농담이 있었음. “test sound”를 계속 누르면 “이 이상 좋아질 수 없어!”라는 대사가 나왔음  
    개인적으로는 **Warcraft II**의 오크 파괴자가 바다 노래를 부르려던 게 제일 웃겼음
  - 스페인어 버전에서는 Demon Hunter를 계속 클릭하면 “난 눈이 멀었지 귀먹은 건 아니야”라고 해서 제일 좋아했음
  - 나는 **Warcraft II**와 **Starcraft**의 추가 대사들을 더 좋아함. Alien 시리즈나 Diablo를 패러디한 부분이 있었음
  - **Warcraft III**에서는 특정 동물을 여러 번 클릭하면 폭발했음
  - “Join the Army”, 그들이 말했지…

- 20년 전쯤 Google의 빌드 시스템 이름이 “grunt”였는데, CL 설명에 “빌드를 10% 더 웃기게 만들어라”라는 문구가 있었음  
  그래서 빌드 로그에 10% 확률로 “zug-zug”가 출력되게 했음
  - kek

- 나도 이걸 해봤는데, Claude Code가 나를 부를 때 “Work complete!”라는 소리를 듣는 게 너무 좋았음  
  [참고 영상](https://www.youtube.com/watch?v=bupagiROLV8)  
  나중엔 프로젝트별로 이벤트에 맞춘 메시지가 더 유용했음. macOS에서는 아래처럼 설정함  
  ```json
  {
    "Stop": [{"hooks": [{"type": "command", "command": "osascript -e 'say \"ProjectX work complete\" volume 0.25'"}]}],
    "Notification": [{"matcher": "permission_prompt","hooks": [{"type": "command","command": "osascript -e 'say \"ProjectX needs help\" volume 0.5'"}]}]
  }
  ```
  - 사실 AppleScript 안 써도 `say` 명령어만으로 가능함
  - 이 설정 파일은 어디에 넣어야 하는지 궁금함

- 이 아이디어 너무 좋음. 다만 **Warcraft II** 목소리였으면 더 좋았을 것 같음
  - 반가움, 동년배 40~45세쯤? **Warcraft II Battle Chest** 세대는 진짜 감성이 다름
  - 나는 **Red Alert II**가 더 좋았음.  
    여러 연구팀에 부탁인데, 로컬에서 음성 설정을 바꿀 수 있는 **JSON 포맷** 같은 걸 만들어줬으면 함.  
    요즘 **OpenAI Codex** 앱을 잘 쓰고 있는데, 이런 기능이 내장되면 훨씬 좋을 것 같음
  - 아니면 **Warcraft I**도 좋음. [관련 영상](https://www.youtube.com/watch?v=oAEG8S-F01A&t=7s)
  - “Your sound card works perfectly” 그 대사도 그립음
  - **Warcraft II 데모**에는 이스터에그가 있었음. “정식 버전에서는 내가 훨씬 웃겨”라는 음성이 있었음

- 예전에 **Warcraft II** 커스텀 맵을 만들 때 건물 건설 시간을 0으로 설정하면, 건물이 즉시 완성되지만 손상된 상태로 나왔음  
  농부에게 농장을 짓게 시켰더니 불타는 농장이 생기고 “Job’s Done!”이 나오는 게 너무 웃겼음

- **Warcraft 3**의 자산을 쓰려면 원본을 소유해야 하는데, 그 언급이 없다는 게 이상함  
  이건 **LLM 학습 과정만큼이나 저작권 침해**임. “AI용이면 예외”라는 법이라도 생긴 건가?
  - 저작권은 이미 죽은 개념임
  - Activision Blizzard 같은 대기업을 위해 눈물 흘릴 필요 없음.  
    **생성형 AI** 덕분에 저작권 체계를 다시 생각하게 될 것임
  - AI의 유일한 장점이라면 기존 생태계를 밀어버릴 수 있다는 점임
  - 하지만 이건 **공정 이용(fair use)** 으로 볼 수도 있음.  
    원작 시장을 해치지 않고, 오히려 향수를 자극해 판매를 늘릴 수도 있음
  - “기업을 보호하라!”는 말이 떠오름

- 이걸 보고 “아, 내가 진짜 원했던 건 이거였구나” 싶었음  
  다만 **Star Trek 컴퓨터의 목소리**로 하고 싶음. Elevenlabs로 바로 시도했더니 30분 만에 “ssh 터널이 끊어졌습니다”라는 경고가 나와서 웃겼음
  - **Majel Barrett Roddenberry**는 Star Trek 창작자 Gene Roddenberry의 아내였음
  - 그 음성 팩을 다시 공유했는지 궁금함

- 멋진 프로젝트지만, `curl | bash` 파이프라인을 보고 시도하지 않기로 했음  
  이런 설치 방식은 이제 너무 낡았고, 좋은 추억을 **Claude와 일**에 엮고 싶지 않음
  - 완전 공감함. 그래서 일반인에게 **Linux**를 추천하기 어려움  
    다만 같은 저장소의 코드인데 일부는 실행하고 일부는 거부하는 건 좀 웃김
  - `curl | bash`를 거부하는 이유를 잘 모르겠음.  
    사실 예전부터 다들 웹에서 설치 파일 받아 실행했음.  
    중요한 건 **출처 신뢰**와 **코드 검토**임. 대안이 뭐가 있을까?
  - 나도 저장소를 **클론해서 사운드 파일만** 썼음. 나중에 터미널 작업에 연결해볼 생각임
  - 나도 같은 생각이었음. 그래서 Claude에게 코드 리뷰를 시킨 뒤, 클론한 버전으로 설치했음

- 이 프로젝트는 단순히 재밌는 장난이 아니라, **다가올 변화의 징조**라고 생각함  
  작년에 에이전트 기반 코딩을 깊게 해보니, 결국 **소프트웨어 공장(software factory)** 개념으로 가게 될 게 분명했음  
  그래서 그 규모의 코드를 관리할 인터페이스를 고민하다 보니, **비디오게임 같은 UI**가 답이라는 결론에 도달했음  
  게임의 정보 표현 방식은 다른 영역에서도 재활용 가능함.  
  겉보기엔 장난 같지만, 실제로는 꽤 진지한 기여라고 봄
  - 맞음. 앞으로 **창의적인 UX**에 엄청난 기회가 열릴 것임