| name | peon-ping-config |
| description | Update peon-ping configuration — volume, pack rotation, categories, active pack, and other settings. Use when user wants to change peon-ping settings like volume, enable round-robin, add packs to rotation, toggle sound categories, or adjust any config. |
peon-ping-config
Update peon-ping configuration settings.
Config location
The config file is at ~/.openpeon/config.json.
Available settings
- volume (number, 0.0–1.0): Sound volume
- default_pack (string): Current sound pack name (e.g.
"peon", "sc_kerrigan", "glados")
- enabled (boolean): Master on/off switch
- pack_rotation (array of strings): List of packs to rotate through per session. Empty
[] uses default_pack only.
- pack_rotation_mode (string):
"random" (default) picks a random pack each session. "round-robin" cycles through in order. "session_override" uses explicit per-session assignments from /peon-ping-use.
- categories (object): Toggle individual sound categories:
session.start, task.acknowledge, task.complete, task.error, input.required, resource.limit, user.spam — each a boolean
- disabled_sounds (object): Disable specific sound files within a pack, keyed by pack name → category → array of filenames.
Prefer the CLI:
peon sounds list [pack], peon sounds disable <category> <file>, peon sounds enable <category> <file>
- annoyed_threshold (number): How many rapid prompts trigger user.spam sounds
- annoyed_window_seconds (number): Time window for the annoyed threshold
- silent_window_seconds (number): Suppress task.complete sounds for tasks shorter than this many seconds
- desktop_notifications (boolean): Toggle notification popups independently from sounds (default:
true)
- use_sound_effects_device (boolean): Route audio through macOS Sound Effects device (
true) or default output (false)
How to update
- Read the config file using the Read tool
- Edit the relevant field(s) using the Edit tool
- Confirm the change to the user
CLI shortcuts
peon volume 0.3
peon toggle
peon rotation round-robin
peon notifications off
peon packs list
peon packs bind <pack>
peon packs unbind
peon packs bindings