@haoyiyin/pi-done-sound

Pi coding agent extension: play a three-note chime when the agent finishes answering.

Packages

Package details

extension

Install @haoyiyin/pi-done-sound from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@haoyiyin/pi-done-sound
Package
@haoyiyin/pi-done-sound
Version
1.0.3
Published
Aug 24, 2026
Downloads
126/mo · 5/wk
Author
haoyiyin
License
MIT
Types
extension
Size
7.7 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@haoyiyin/pi-done-sound

Pi extension. Plays a three-note chime (E5–G5–C6) when the main agent is fully done — after retries, compaction, and follow-ups. Nested subagent sessions do not chime.

macOS uses afplay. Windows uses System.Media.SoundPlayer. Linux tries paplay / aplay.

Install

pi install npm:@haoyiyin/pi-done-sound

Try once without installing:

pi -e npm:@haoyiyin/pi-done-sound

Usage

Reload the current session (/reload) after install.

  • /done-sound — toggle
  • /done-sound on / /done-sound off
  • /done-sound test — play now

Custom wav:

export PI_DONE_SOUND=/path/to/file.wav

On/off is stored in ~/.pi/agent/done-sound.json. The generated chime is cached at ~/.pi/agent/done-sound-chime.wav.