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

 (github.com/tonyyont)
37P by GN⁺ | ★ favorite | 댓글 14개
  • 워크래프트/스타크래프트/젤다 등의 음성을 활용해 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에서 미리 듣기 가능
  • 사용자는 peon packs use 명령으로 팩 전환 가능

작동 방식

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

기타 정보

GeekNews Weekly에 포함된 글입니다. 에디터 코멘트 보기

함께 보면 좋은 글 β

curioe   [-]

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

답변달기
yangeok   [-]

ㅋㅋㅋㅋ ready to work

답변달기
kaydash   [-]

ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ

답변달기
tesla52   [-]

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

답변달기
qlghwp123   [-]

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

답변달기
edunga1   [-]

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

답변달기
t7vonn   [-]

ㅋㅋㅋ 너무 재밌습니다

답변달기
ryj0902   [-]

Ready to work? Work, work.

답변달기
winterjung   [-]

좀 더 간단히 하시고 싶으면 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"}]}  
    ]  
  }  
}
답변달기
xguru   [-]

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

답변달기
mammal   [-]

최근 본 프로젝트중 최고

답변달기
cysl0   [-]

ㅋㅋㅋㅋㅋㅋㅋ

답변달기
GN⁺   [-]
Hacker News 의견들

  • 드디어 “Claude, 또 하나의 쓸모없는 SaaS 만들어줘” 같은 게 아니라 LLM으로 진짜 유용한 작업을 하는 사람이 나왔음
    예언대로 진짜 차별화 포인트는 창의성, 코딩 실력이 아님

    • 동의함. 이제 누군가 Majel Barrett의 목소리를 완벽히 재현해줘서 컴퓨터가 진짜 미래처럼 들리게 되길 기다리고 있음
      이미 10년 전쯤 가능했을 텐데, 고품질 오디오 샘플들이 저작권자와 상업적 이해관계 사이에 묶여버려서 프로젝트가 지연된 게 아쉬움
    • 재밌긴 하지만, 무작위 vibe-coded .sh 스크립트에서 공급망 공격이나 악성 코드에 주의해야 함
      예를 들어 다른 스크립트를 다운로드해 실행하거나, ~/.bashrc를 수정하고, 원격 JSON을 파싱해 파일을 받아오는 식임
    • 창의성이 곧 왕이 될 것 같은 흐름임
    • 맞음. peon 알림 기능이 완벽한 예시임. 작지만 도구를 더 쓰고 싶게 만드는 요소임
      요즘 좋은 소프트웨어는 “만드는 사람이 즐거웠다”는 느낌이 남. 단순히 작동하는 도구와 “이거 재밌네” 하는 도구의 차이를 바로 느낄 수 있음

  • 이 프로젝트를 보니 Warcraft 1이 떠올랐음. 같은 유닛을 계속 클릭하면 점점 짜증 섞인 반응을 하는데, 인간 병사가 “왜 계속 만지는 거야?”라고 말하던 게 최고였음
    관련 영상

    • 사운드 설정 프로그램에서도 같은 농담이 있었음. “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!”라는 소리를 듣는 게 너무 좋았음
    참고 영상
    나중엔 프로젝트별로 이벤트에 맞춘 메시지가 더 유용했음. macOS에서는 아래처럼 설정함

    {
  "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도 좋음. 관련 영상
    • “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에 엄청난 기회가 열릴 것임
답변달기