Willem van den Ende 383cb46fe7 feat(pi-notifications): add standalone test-notify.ts and fix AppleScript sound bug
- Add packages/pi-notifications/src/test-notify.ts for isolated testing
  - Run with: node --input-type=module -e "import {createJiti} from ..." ./packages/pi-notifications/src/test-notify.ts
  - Decoupled from agent loop — verifies osascript in extension context
- Fix: 'default' is a reserved word in AppleScript, skip sound param when sound='default'
- Synced fix to auto-discovery extension path
2026-04-28 12:10:30 +01:00
..

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