Sound Events

PeonPing implements the Coding Event Sound Pack Specification (CESP) — an open standard for coding event sounds that any agentic IDE can adopt.

Event Categories

Every sound in PeonPing is organized into CESP categories. Each category triggers in response to specific IDE events:

When it plays: When a new coding session beginsHook events:

SessionStart
First interaction with the agent

Example sounds:

“Ready to work?” (Peon)
“Yes, milord?” (Peasant)
“Battlecruiser operational” (StarCraft Battlecruiser)
“Oh, it’s you.” (GLaDOS)

Configuration:

peon preview session.start  # Test all greeting sounds

When it plays: When the agent finishes a task and waits for your inputHook events:

Stop
AfterAgent (Gemini CLI)
post_cascade_response (Windsurf)

Example sounds:

“Work, work.” (Peon)
“Job’s done!” (Peasant)
“I gotcha” (Kerrigan)
“Make it happen” (Battlecruiser)

Smart filtering:

{
  "silent_window_seconds": 10,
  "suppress_subagent_complete": true
}

Suppress sounds for tasks shorter than 10 seconds or when sub-agents complete.

When it plays: When the agent needs your permission or inputHook events:

PermissionRequest
Notification (with permission context)

Example sounds:

“Something need doing?” (Peon)
“Hmm?” (Kerrigan)
“What you want?” (Peon)

Use case: Tool approval requests, file write confirmations

When it plays: When a tool or command failsHook events:

PostToolUseFailure
errorOccurred (GitHub Copilot)
AfterTool with failure status

Example sounds:

“I can’t do that.” (Peon)
“Son of a bitch!” (Duke Nukem)
“Your entire team is dead.” (GLaDOS)

When it plays: When the agent hits rate limits or token limitsHook events:

PreCompact (context compaction)
API rate limit errors

Example sounds:

“Zug zug.” (Peon)

Note: Pack-dependent — not all packs include resource limit sounds

When it plays: When you send 3+ prompts in 10 secondsConfiguration:

{
  "annoyed_threshold": 3,
  "annoyed_window_seconds": 10
}

Example sounds:

“Me busy, leave me alone!” (Peon)
“Easily amused, huh?” (Kerrigan)

Purpose: Easter egg to discourage rapid-fire prompting

When it plays: When the agent acknowledges receiving your taskHook events:

PreToolUse
Early task acceptance

Example sounds:

“I read you.” (Kerrigan)
“On it.” (Generic)

Default: Disabled (too noisy)

{
  "categories": {
    "task.acknowledge": false
  }
}

Extended Categories

These categories are defined in the CESP spec but not currently triggered by built-in hooks:

Category	Purpose	Status
`session.end`	Session termination	Spec only
`task.progress`	Progress updates during long tasks	Spec only

Managing Event Categories

Enable/Disable Categories

Toggle specific event categories without affecting others:

# Using the CLI
peon preview --list  # Show all categories in active pack

# Test a specific category
peon preview task.error

# Or ask Claude to modify your config
# "Disable session start sounds"
# "Enable task acknowledge sounds"

Configuration File

Edit ~/.claude/hooks/peon-ping/config.json directly:

{
  "categories": {
    "session.start": true,
    "task.acknowledge": false,
    "task.complete": true,
    "task.error": true,
    "input.required": true,
    "resource.limit": true,
    "user.spam": true
  }
}

Advanced: Per-pack category availability

Not all sound packs include all categories. The openpeon.json manifest in each pack defines which categories are supported.When a category triggers but the active pack doesn’t have sounds for it, PeonPing silently skips playback.Example: The glados pack has extensive task.error sounds, while some minimal packs may only support session.start and task.complete.

Get Started

Core Features

Configuration

CLI Reference

Integrations

Advanced

Resources

Event Categories

Extended Categories

Managing Event Categories

Enable/Disable Categories

Configuration File

Event Flow Diagram

Sound Packs

Notifications

Build docs developers (and LLMs) love

Get Started

Core Features

Configuration

CLI Reference

Integrations

Advanced

Resources

​Event Categories

​Extended Categories

​Managing Event Categories

​Enable/Disable Categories

​Configuration File

​Event Flow Diagram

​Related Configuration

Sound Packs

Notifications

Build docs developers (and LLMs) love

Event Categories

Extended Categories

Managing Event Categories

Enable/Disable Categories

Configuration File

Event Flow Diagram

Related Configuration