Skip to content
Development
Skill

/peon-ping-toggle

Toggle peon-ping sound notifications on/off. Use when user wants to mute, unmute, pause, or resume peon sounds during a Claude Code session. Also handles config changes like volume, pack rotation, categories — any peon-ping setting.

From plugin
peon-ping
5k5 skills
Install
$ npx -y skills add PeonPing/peon-ping --skill peon-ping-toggle --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/peon-ping-toggle

Context preview

The summary Claude sees to decide when to auto-load this skill.

Toggle peon-ping sound notifications on/off. Use when user wants to mute, unmute, pause, or resume peon sounds during a Claude Code session. Also handles config changes like volume, pack rotation, categories — any peon-ping setting.

SKILL.md

peon-ping-toggle.SKILL.md
name: peon-ping-toggle
description: Toggle peon-ping sound notifications on/off. Use when user wants to mute, unmute, pause, or resume peon sounds during a Claude Code session. Also handles config changes like volume, pack rotation, categories — any peon-ping setting.
user_invocable: true

peon-ping-toggle

Toggle peon-ping sounds on or off. Also handles any peon-ping configuration changes.

Toggle sounds

On Unix, run the following command using the Bash tool:

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

On Windows, use the PowerShell tool:

$claudeDir = $env:CLAUDE_CONFIG_DIR
if (-not $claudeDir -or $claudeDir -eq "") {
  $claudeDir = Join-Path $HOME ".claude"
}
& (Join-Path $claudeDir "hooks/peon-ping/peon.ps1") toggle

Report the output to the user. The command will print either:

  • `peon-ping: sounds paused` — sounds are now muted
  • `peon-ping: sounds resumed` — sounds are now active

What This Toggles

This command toggles the **master audio switch** (`enabled` config). When disabled:

  • ❌ Sounds stop playing
  • ❌ Desktop notifications also stop (they require sounds to be enabled)
  • ❌ Mobile notifications also stop

**For notification-only control**, use `/peon-ping-config` to set `desktop_notifications: false`. This keeps sounds playing while suppressing desktop popups.

Examples

"Mute peon-ping completely" → Sets `enabled: false` "Just disable the popups but keep sounds" → Sets `desktop_notifications: false` (use `/peon-ping-config` instead)

Configuration changes

For any other peon-ping setting changes (volume, pack rotation, categories, active pack, etc.), use the `peon-ping-config` skill.

Read more
Ships withpeon-ping

Game character voice lines + visual overlay notifications when your AI coding agent needs attention — or let the agent pick its own sound via MCP. AI coding agents don't notify you when they finish or need permission.

Get the whole plugin
Stats
4,984
Stars
369
Forks
Active
Maintenance
Shell
Language
MIT
License
3h ago
Last commit
6mo ago
Created

Repo: PeonPing/peon-ping