@arvoretech/pi-turn-notification

PI extension that sends a native desktop notification at the end of each agent turn (macOS and Linux)

Package details

extension

Install @arvoretech/pi-turn-notification from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@arvoretech/pi-turn-notification

Pi manifest JSON

{
  "extensions": [
    "./dist/index.js"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Pi extension that sends a native desktop notification at the end of each agent turn.

Works on macOS and Linux:

macOS: uses osascript to trigger native notifications with the "Glass" sound.
Linux: uses notify-send (libnotify) for the notification, and plays a sound via canberra-gtk-play or paplay when available.

On Linux, make sure libnotify is installed (notify-send binary). The sound is best-effort and silently skipped if no player is available.

pnpm add @arvoretech/pi-turn-notification

Add to your .pi/config.json:

{
  "extensions": ["@arvoretech/pi-turn-notification"]
}