pi extension: play a sound when the agent finishes a prompt
npm install pi-dingA pi extension that plays a sound when the agent finishes processing a prompt (when it’s ready for the next input).
``bash`
pi install npm:pi-ding
After installing, restart pi or run /reload inside pi.
pi-ding stores its config inside pi’s settings files, so you can configure once and then just run pi.
Settings locations (project overrides global):
- Global: ~/.pi/agent/settings.json
- Project:
Add a ding key:
`json`
{
"ding": {
"enabled": true,
"player": "mpv",
"args": ["--no-video", "--really-quiet"],
"path": "~/sounds/done.mkv"
}
}
Notes:
- args is optional.player
- If is omitted, pi-ding tries common players automatically (mpv, ffplay, paplay, afplay, aplay).
- Supported audio formats depend on the chosen player.
Inside pi:
- /ding edit → edits project config (.pi/settings.json)/ding edit global
- → edits global config (~/.pi/agent/settings.json)
- /ding — toggle enabled (saved to project settings by default)/ding on
- / /ding off — set enabled/ding test
- — play sound immediately/ding info
- — show debug info (effective config, resolved file, players)/ding reload
- — reload settings from disk
You typically won’t need these once config exists, but they can override settings for a single run:
`bash``
pi --no-ding
pi --ding-player mpv --ding-path "./done.mkv"
pi --ding-args '["--no-video","--really-quiet"]'
MIT