PeonPing/peon-ping

peon‑ping – AIコーディングアシスタント向けの音声・視覚的インジケータ

何であるか – peon‑ping は、AI駆動のコーディングアシスタント（Claude Code、GitHub Copilot、Cursorなど）に接続する軽量なヘルパーです。アシスタントがタスクを完了したとき、権限が必要なとき、エラーが発生したとき、またはその他の注目すべきイベントが発生すると、短い音声ライン（たとえば Warcraft や Portal のようなゲームのミーム風の台詞）を再生し、画面に太字のバナーを表示します。この目的は、ターミナルやIDEを常に監視しなくても、作業の流れを維持できるようにすることです。

動作方法 – このプロジェクトは、小さなCLI（peon）と、対応するアシスタントがキーポイントで呼び出すフックを同梱しています。これらのフックは Coding Event Sound Pack Specification (CESP) を呼び出し、task.complete や input.required などのイベントを、サウンドパック に格納された音声ファイルにマッピングします。CLIは以下の機能も管理します：

• サウンドパックのインストールと切り替え（コミュニティ寄稿パックも含む）。
• ボリューム制御、音声カテゴリの有効/無効、デスクトップオーバーレイの表示設定。
• WSL2、SSH、devcontainers などのリモート開発環境での音声リレー・デーモンによる統合。
• 無料の ntfy サービスを介したオプションのモバイルプッシュ通知。

主な機能

機能	得られるもの
広範なアシスタント対応	Claude Code、Amp、GitHub Copilot、Codex、Cursor、Kiro、Qwen Code など、多数のアシスタント用の事前作成済みアダプタ。
クロスプラットフォーム	macOS、Linux、Windows、WSL2、MSYS2 – 音声再生は自動的に適応（WPF MediaPlayer、PlaySound、またはffmpeg変換されたWAV）。
サウンドパック	ゲームキャラクター（例：GLaDOS、Kerrigan）をテーマにした完成済みパックと、コミュニティパックのレジストリ。パックはインストール、プロジェクトに紐づけ、自動ローテーション可能。
視覚オーバーレイ	任意の画面に表示される大規模でカスタマイズ可能なバナー（ネオン、ガラス、サクラ、Jarvis）と、ターミナルタブタイトルの更新。
CLI制御	peon toggle、peon volume 0.7、peon packs install …、peon preview など。すべてのコマンドでタブ補完が可能。
集中モードに応じたミュート	macOSの「不要な通知を無効にする」モードやヘッドセットの検出時に音声をオプションでミュート。
リモート開発対応	音声リレー・デーモンがコンテナやSSHセッションからの音声をホストマシンに転送。
モバイル通知	無料のntfy経由でプッシュ通知。peon mobile ntfy <topic> で設定可能。
拡張可能な設定	~/.claude/hooks/peon-ping/（またはプロジェクトローカルの .claude/）にJSON形式で保存。インタラクティブな peon setup ウィザードも利用可能。

一般的なワークフロー

1. Homebrew、提供されたスクリプト、またはNixでインストール。
2. peon setup を実行 – ボリューム、音声を有効にするイベントカテゴリ、オーバーレイテーマなどを選択。
3. インストーラーが適切なフックスクリプトをAIコーディングアシスタントに登録（例：~/.claude/settings.json にエントリを追加）。
4. コードを書いている間、アシスタントは自動的に音声やオーバーレイをトリガー：生成が完了すると「Work complete.」、権限が必要になると「Hmm?」など。
5. peon toggle または Claude Code 内のスラッシュコマンド /peon-ping-toggle を使って、即座にミュート/ミュート解除。また、macOSのFocusモードを尊重するように設定可能。

なぜ使うべきか – コーディングアシスタントをバックグラウンドで長時間実行していると、完了時や制限に達したタイミングを忘れがちです。peon‑pingは音声と視覚的インジケータを提供し、IDEを頻繁に確認しなくても、作業の集中を保てるようになります。

---

インストールのショートカット

• Homebrew（macOS/Linux）: brew install PeonPing/tap/peon-ping && peon-ping-setup
• 1行スクリプト（macOS/Linux/WSL2）: curl … | bash
• Windows PowerShellインストーラー：-All、-Packs、-Local などオプションあり。
• Nix: nix run github:PeonPing/peon-ping -- status

詳細情報 – ライブデモは https://peonping.com/ で確認可能。CESP仕様リポジトリ（github.com/PeonPing/openpeon）、コミュニティパックレジストリ（openpeon.com）も参照してください。