peon-ping-config

peon-ping-config

peon-ping の設定を更新します。

設定ファイルの場所

設定ファイルは ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/peon-ping/config.json にあります。

利用可能な設定

• volume（数値、0.0～1.0）：音量
• default_pack（文字列）：現在のサウンドパック名（例："peon"、"sc_kerrigan"、"glados"）。レガシーキーの active_pack もフォールバックとして使用できます。
• enabled（ブール値）：全体のオン／オフ切り替え
• pack_rotation（文字列の配列）：セッションごとに切り替えるサウンドパックのリスト。空の [] の場合は default_pack のみを使用します。
• pack_rotation_mode（文字列）："random"（デフォルト）では、セッションごとにランダムなサウンドパックを選びます。"round-robin" では、順番に切り替えます。"session_override" では、/peon-ping-use によるセッションごとの明示的な割り当てを使用します。無効または見つからないサウンドパックは default_pack にフォールバックし、古い割り当ては削除されます。レガシー値の "agentskill" もエイリアスとして使用できます。
• categories（オブジェクト）：CESP サウンドカテゴリーごとに有効／無効を切り替えます。
  • session.start、task.acknowledge、task.complete、task.error、input.required、resource.limit、user.spam — それぞれブール値
• disabled_sounds（オブジェクト）：サウンドパック内の特定のサウンドファイルを無効にします。サウンドパック名 → カテゴリー → ファイル名（ベース名）の配列をキーとして指定します。例：

  "disabled_sounds": {
    "peon": { "session.start": ["Hello1.wav"] }
  }
  

  カテゴリー内のすべてのサウンドが指定されている場合、そのカテゴリーは無音になります。CLI の使用を推奨します。

  peon sounds list [pack]
  peon sounds disable <category> <file> [--pack=<name>]
  peon sounds enable  <category> <file> [--pack=<name>]
  

• annoyed_threshold（数値）：連続したプロンプトが何回あると user.spam サウンドを再生するか
• annoyed_window_seconds（数値）：annoyed_threshold の時間枠
• silent_window_seconds（数値）：タスクがこの秒数より短い場合、task.complete サウンドを抑制します
• session_ttl_days（数値、デフォルト：7）：古いセッションごとのサウンドパック割り当てを期限切れにするまでの日数（session_override モード使用時）
• desktop_notifications（ブール値）：サウンドとは別に通知ポップアップを切り替えます（デフォルト：true）
• use_sound_effects_device（ブール値）：macOS のサウンドエフェクトデバイス（true）または afplay 経由のデフォルト出力（false）に音声を出力します。macOS のみで有効です。デフォルト：true

更新方法

1. Read ツールを使って設定ファイルを読み取ります
2. Edit ツールを使って該当するフィールドを編集します
3. 変更内容をユーザーに確認します

よく使われる設定例

サウンドを維持したままデスクトップ通知のポップアップを無効にする

ユーザーのリクエスト：「デスクトップ通知を無効にして」

操作： 設定で desktop_notifications: false にします

結果：

• ✅ サウンドは引き続き再生されます（音声リマインダー）
• ❌ デスクトップ通知のポップアップは抑制されます
• ✅ モバイル通知には影響しません（別の切り替え設定）

代替 CLI コマンド：

peon notifications off
# or
peon popups off

音量を調整する

ユーザーのリクエスト：「音量を30%にして」

操作： 設定で volume: 0.3 にします

サウンドパックの順繰り切り替えを有効にする

ユーザーのリクエスト：「peon と glados でサウンドパックの順繰り切り替えを有効にして」

操作： 次のように設定します。

{
  "pack_rotation": ["peon", "glados"],
  "pack_rotation_mode": "round-robin"
}

ディレクトリごとのサウンドパック割り当て

サウンドパックを作業ディレクトリに永続的に関連付け、そのディレクトリ内のすべてのセッションで適切なサウンドパックが自動的に使われるようにします。path_rules 設定キー（{ "pattern": "<glob>", "pack": "<name>" } オブジェクトの配列）を使用します。

CLI コマンド

# Bind a pack to the current directory
peon packs bind <pack>
# e.g. peon packs bind glados
# → bound glados to /Users/dan/Frontend

# Bind with a custom glob pattern (matches any dir with that name)
peon packs bind <pack> --pattern "*/Frontend/*"

# Auto-download a missing pack and bind it
peon packs bind <pack> --install

# Remove binding for the current directory
peon packs unbind

# Remove a specific pattern binding
peon packs unbind --pattern "*/Frontend/*"

# List all bindings (* marks rules matching current directory)
peon packs bindings

手動で設定する

config.json の path_rules 配列は、直接編集することもできます。

{
  "path_rules": [
    { "pattern": "/Users/dan/Frontend/*", "pack": "glados" },
    { "pattern": "*/backend/*", "pack": "sc_kerrigan" }
  ]
}

パターンには Python の fnmatch グロブ構文を使用します。最初に一致したルールが適用されます。パスルールは default_pack と pack_rotation より優先されますが、session_override の割り当てよりは優先度が低くなります。

利用可能なサウンドパックの一覧

利用可能なサウンドパックを表示するには、次を実行します。

bash "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/peon.sh packs list