@fyeeme/pi-notify
Desktop notifications for pi — fires a native OSC 777 notification (Ghostty, iTerm2, WezTerm, rxvt-unicode) when the agent finishes and is waiting for input; the last assistant message, markdown-flattened and truncated to 200 characters, becomes the notif
Package details
Install @fyeeme/pi-notify from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@fyeeme/pi-notify- Package
@fyeeme/pi-notify- Version
1.0.0- Published
- Nov 9, 2026
- Downloads
- 345/mo · 345/wk
- Author
- pitpatfitness
- License
- MIT
- Types
- extension
- Size
- 16.7 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-notify
Desktop notifications for pi: when the agent finishes a run and is waiting for your input, a native terminal notification pops with the last thing it said.
Packaged from mitsuhiko/agent-stuff extensions/notify.ts (Apache-2.0). The implementation is carried over as-is; single-file index.ts, no build step, no dependencies.
What it does
- OSC 777 notifications — writes
ESC ] 777 ; notify ; title ; body BELto stdout on everyagent_end. Supported terminals: Ghostty, iTerm2, WezTerm, rxvt-unicode. Not supported: Kitty (uses OSC 99), Terminal.app, Windows Terminal, Alacritty. - Body from the last assistant message — rendered through a plain markdown theme (no styling, links keep only their label), stripped of terminal sequences and control characters (an embedded OSC 8 hyperlink would truncate the notification), whitespace collapsed onto one line, truncated to 200 characters with
…. - Title —
πwhen there is a body;Ready for inputwith an empty body when the last assistant message has no text.
Install
pi install npm:@fyeeme/pi-notify
or copy/link this directory into ~/.pi/agent/extensions/ (global) or .pi/extensions/ (project).
Usage
Nothing to configure — installed means active. Run a task, switch away from the terminal, and the notification tells you when pi is waiting.
Development
npm install --ignore-scripts
npm test # vitest
npm run typecheck
License
MIT. Derived from mitsuhiko/agent-stuff extensions/notify.ts (Apache-2.0).