peonping/peon-ping

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.

First seen Feb 14, 2026

Installation

$ npx skills add peonping/peon-ping --skill peon-ping-toggle

Also in this package

Other skills from peonping/peon-ping.

npx skills add peonping/peon-ping

Browse all from peonping/peon-ping

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 5.0K
License LICENSE
Default branch main
Open issues 27
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,724 B
  • docs SUMMARY.md 258 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 89 installs

SKILL.md

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.