pi-boop
Pi extension that plays the terminal bell or a custom sound when Pi is waiting for input.
Package details
Install pi-boop from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-boop- Package
pi-boop- Version
1.0.1- Published
- Sep 12, 2026
- Downloads
- 382/mo · 188/wk
- Author
- bradennss
- License
- MIT
- Types
- extension
- Size
- 9.6 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-boop
A Pi extension that plays the terminal bell or a custom sound when Pi is waiting for input.
Install
# from npm
pi install npm:pi-boop
# or from git
pi install git:github.com/bradennss/pi-boop
# try it for a single run without installing
pi -e npm:pi-boop
Usage
Once installed, pi-boop rings the terminal bell every time Pi settles and waits for you.
Run /boop at any time to play the sound and check your setup.
Play a custom sound
Point pi-boop at an audio file to play it instead of the bell:
export PI_BOOP_SOUND=~/sounds/ready.wav
Or set it for a single run:
pi --boop-sound ~/sounds/ready.wav
pi-boop plays the file with the platform's player (afplay on macOS, paplay on Linux, PowerShell on Windows). If the file cannot be played, it falls back to the terminal bell.
Turn it off
export PI_BOOP_DISABLE=1 # every run
pi --boop-off # a single run
Requirements
- Node.js >= 20.
Development
pnpm install
pnpm run check
Contributing
Every change that affects the published package needs a changeset:
pnpm changeset