Willem van den Ende 45a13fd08c feat(pi-notifications): add PI_NOTIFICATION_DEBUG mode with visible steer signal

- Add PI_NOTIFICATION_DEBUG=true env var
- When enabled, calls ctx.ui.steer() instead of desktop notification
- Lets you verify trigger logic in the agent loop without actual notifications
- Synced to both monorepo and auto-discovery extension paths

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

818 B

Raw Blame History

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

818 B Raw Blame History