@eleith-pi/notifications

Desktop and terminal notifications when Pi finishes a run

Packages

Package details

extension

Install @eleith-pi/notifications from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@eleith-pi/notifications
Package
@eleith-pi/notifications
Version
0.1.2
Published
Oct 8, 2026
Downloads
239/mo · 13/wk
Author
eleith
License
MIT
Types
extension
Size
13.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

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

README

notifications

after a 15 second LLM run (or a failed call), this sends a desktop notification

why

so i can regain focus if i switched away from my terminal.

attempts to use notify-send with a fallback to OSC 777.

how to install

pi install npm:@eleith-pi/notifications

how to use

send in a prompt and watch the magic, or force it with /eleith:notifications test

use /eleith:notifications off to stop the magic

how to configure

update ~/.pi/agent/extensions/eleith.json with the following:

{ "commandPrefix": "personal" }