History

Willem van den Ende 823af3c486 feat(pi-notifications): switch to afplay audio instead of desktop notifications

- Uses afplay to play an audio file (default: Glass.aiff)
- Configurable via PI_NOTIFICATION_AUDIO env var
- Works from sandboxed context — no osascript needed
- test-notify.ts verifies audio playback standalone
- Synced to auto-discovery extension path

2026-04-28 13:02:18 +01:00

src

feat(pi-notifications): switch to afplay audio instead of desktop notifications

2026-04-28 13:02:18 +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

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

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

README.md

pi-notifications

Desktop notifications for pi agent events via macOS Notification Center.

What it does

Shows a system notification 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`	Notification when agent finishes
`PI_NOTIFICATION_TITLE`	`pi`	Notification title
`PI_NOTIFICATION_SOUND`	`default`	macOS sound (Bottle, Ping, Pop, etc.) or `""` for silent

Usage

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

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

Then reload pi:

/reload

License

MIT