History

Willem van den Ende 113878e83f chore(pi-notifications): remove debug mode and console.log noise

- Remove PI_NOTIFICATION_DEBUG env var and steer signal logic
- Remove console.log on extension load
- Keep only: session_start notification + agent_end beep
- Clean README without debug references

2026-04-28 13:04:33 +01:00

src

chore(pi-notifications): remove debug mode and console.log noise

2026-04-28 13:04:33 +01:00

package.json

feat(pi-notifications): add PI_NOTIFICATION_DEBUG mode with visible steer signal

2026-04-28 12:09:06 +01:00

README.md

chore(pi-notifications): remove debug mode and console.log noise

2026-04-28 13:04:33 +01:00

README.md

pi-notifications

Audio alerts for pi agent events via afplay.

What it does

Plays a sound when the agent finishes a turn, so you can step away and get alerted when input is needed.

Configuration

Env var	Default	Description
`PI_NOTIFICATIONS_ENABLED`	`true`	Set to `false` to disable all notifications
`PI_NOTIFICATION_AGENT_END`	`true`	Play sound when agent finishes
`PI_NOTIFICATION_AUDIO`	`/System/Library/Sounds/Glass.aiff`	Path to audio file (.aiff/.wav/.mp3)

Standalone tester

Verify audio playback:

node --input-type=module -e "import {createJiti} from './node_modules/.pnpm/@mariozechner+jiti@2.6.5/node_modules/@mariozechner/jiti/lib/jiti.mjs'; const jiti = createJiti(); await jiti.import('./packages/pi-notifications/src/test-notify.ts');"

Available macOS sounds

/System/Library/Sounds/Bottle.aiff
/System/Library/Sounds/Cork.aiff
/System/Library/Sounds/Frog.aiff
/System/Library/Sounds/Glass.aiff       ← default
/System/Library/Sounds/Hero.aiff
/System/Library/Sounds/Morse.aiff
/System/Library/Sounds/Ping.aiff
/System/Library/Sounds/Pop.aiff
/System/Library/Sounds/Submarine.aiff
/System/Library/Sounds/Sosumi.aiff
/System/Library/Sounds/Tink.aiff

Usage

Add to ~/.pi/agent/settings.json:

{
  "packages": [
    "/path/to/packages/pi-notifications"
  ]
}

Then reload pi:

/reload

License

MIT