概要

peon-ping は、Claude Codeの進行状況や許可が必要なタイミングを Warcraft III Peonの音声 で通知するツール。 macOS と WSL2 に対応し、インストールやアップデートも コマンド一発 で完了。 サウンドパックの切り替え や通知の一時停止も簡単操作。 ターミナルのタブタイトル更新 やデスクトップ通知にも対応。 カスタマイズ性 が高く、独自パックの追加も可能。

peon-ping 概要

• Claude Code での作業進行や許可要求を、 Warcraft III Peonの音声 で即時通知
• 通知を逃して作業効率が下がる 問題の解消
• ターミナル がOrgrimmarの雰囲気になるエンタメ性
• 公式デモサイト ：peon-ping.vercel.app

インストール方法

• コマンド一発 で導入（10秒以内完了）

  curl -fsSL https://raw.githubusercontent.com/tonyyont/peon-ping/main/install.sh | bash
  

  • macOS および WSL2 (Windows) 対応 再実行でアップデート （サウンド・設定は維持）

サウンドイベント例

• セッション開始 ：挨拶「Ready to work?」「Yes?」「What you want?」
• タスク完了 ：承認「Work, work.」「I can do that.」「Okie dokie.」
• 許可要求 ：警告「Something need doing?」「Hmm?」「What you want?」
• 急連続プロンプト ：イースターエッグ「Me busy, leave me alone!」
• • タブタイトル （例：● project: done）や デスクトップ通知 もサポート

クイック操作・ミュート機能

• 会議やペア作業時のミュート切り替え

  • Slashコマンド ：/peon-ping-toggle（Claude Code CLI内）
  • CLIコマンド ：peon --toggle（任意ターミナルから）
• • • peon --pause　サウンドミュート
    • peon --resume　サウンド再開
    • peon --status　状態確認
    • peon --packs　利用可能パック一覧
    • peon --pack <name>　特定パックへ切替
    • peon --pack　次パックへ切替
  • Tab補完対応 （peon --pack <TAB>で候補表示） ミュート状態はセッション跨いで維持 （タブタイトルは継続更新）

設定・カスタマイズ

• 設定ファイル ：~/.claude/hooks/peon-ping/config.json

  • volume：0.0～1.0（オフィスでも静かに設定可能）
  • categories：各サウンド種別のON/OFF
  • annoyed_threshold・annoyed_window_seconds：イースターエッグ発動回数と時間
  • pack_rotation：パック名配列（セッションごとにランダム選択。空配列ならactive_packを使用）

サウンドパック一覧

• peon（デフォルト） ：Orc Peon（Warcraft III）「Ready to work?」「Work, work.」など　by @tonyyont
• peon_fr ：Orc Peon（フランス語）by @thomasKn
• peon_pl ：Orc Peon（ポーランド語）by @askowronski
• peasant ：Human Peasant（Warcraft III）by @thomasKn
• peasant_fr ：Human Peasant（フランス語）by @thomasKn
• ra2_soviet_engineer ：Soviet Engineer（Red Alert 2）by @msukkari
• sc_battlecruiser ：Battlecruiser（StarCraft）by @garysheng
• sc_kerrigan ：Sarah Kerrigan（StarCraft）by @garysheng
• • • peon --pack ra2_soviet_engineer　特定パックへ切替
    • peon --pack　次パックへ
    • peon --packs　全パック一覧
    • ~/.claude/hooks/peon-ping/config.jsonでactive_pack直接設定
  • 独自パック追加方法 はCONTRIBUTING.md参照

アンインストール方法

• bash ~/.claude/hooks/peon-ping/uninstall.sh
  

動作要件

• macOS （afplay、AppleScript利用）
• WSL2 （PowerShell MediaPlayer、WinForms利用）
• Claude Code （hooks対応版）
• python3

動作仕組み

• peon.sh がClaude Codeの各イベント（SessionStart、UserPromptSubmit、Stop、Notification）にフック
• イベントごとにサウンドカテゴリを割り当て、 重複を避けてランダム再生
• macOS はafplay、 WSL2 はPowerShell MediaPlayerで再生
• ターミナルのタブタイトル も自動更新
• サウンドファイル は各パブリッシャー（Blizzard Entertainment、EA）所有。リポジトリ内に便宜上同梱

公式リンク

• ランディングページ ：peon-ping.vercel.app
• ライセンス ：MIT