pi-ding

pi extension: play a sound when the agent finishes a prompt

Package details

extension

Install pi-ding from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-ding

Pi manifest JSON

{
  "extensions": [
    "./extensions/ding.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

A pi extension that plays a sound when the agent finishes processing a prompt (when it’s ready for the next input).

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):

Add a ding key:

{
  "ding": {
    "enabled": true,
    "player": "mpv",
    "args": ["--no-video", "--really-quiet"],
    "path": "~/sounds/done.mkv"
  }
}

Notes:

args is optional.
If player is omitted, pi-ding tries common players automatically (mpv, ffplay, paplay, afplay, aplay).
Supported audio formats depend on the chosen player.

Inside pi:

You typically won’t need these once config exists, but they can override settings for a single run:

pi --no-ding
pi --ding-player mpv --ding-path "./done.mkv"
pi --ding-args '["--no-video","--really-quiet"]'

MIT