pi-poly-notify

Highly configurable desktop/sound/Pushover notifications when Pi agent turn finishes and took longer than a definable threshold

Package details

← Back
extension

Install pi-poly-notify from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-poly-notify
Package
pi-poly-notify
Version
0.1.2
Published
Feb 3, 2026
Downloads
36/mo · 15/wk
Author
w-winter
License
MIT
Types
extension
Size
23.3 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "extensions/poly-notify/index.ts"
  ]
}

Security note

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

README

Notifications for Pi (pi-poly-notify)

Sends notifications when an agent turn finishes and took longer than a configurable threshold.

Supports:

  • desktop popups (macOS)
  • sounds (macOS afplay), with plenty of customization options
  • optional Pushover notifications (useful for Apple Watch / iOS)

Install

From npm:

pi install npm:pi-poly-notify

From the dot314 git bundle (filtered install):

Add to ~/.pi/agent/settings.json (or replace an existing unfiltered git:github.com/w-winter/dot314 entry):

{
  "packages": [
    {
      "source": "git:github.com/w-winter/dot314",
      "extensions": ["extensions/poly-notify/index.ts"],
      "skills": [],
      "themes": [],
      "prompts": []
    }
  ]
}

Setup

Create your config file:

  • copy notify.json.example → notify.json

Location:

  • ~/.pi/agent/extensions/poly-notify/notify.json

Usage

  • Command: /notify
  • Shortcut: Alt+N (toggle on/off)

Quick forms:

  • /notify on|off
  • /notify popup (toggle popup)
  • /notify pushover (toggle Pushover)
  • /notify volume (toggle constant ↔ timeScaled)
  • /notify <seconds> (set minimum duration threshold)
  • /notify <sound-alias> (set sound)

Notes

  • macOS-only out of the box (uses osascript + afplay)
  • Pushover requires curl and valid userKey + apiToken in config