@ravshansbox/pi-notification

OSC 777 terminal notification extension for pi

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@ravshansbox/pi-notification

Package: @ravshansbox/pi-notification
Version: 1.1.4
Published: Nov 1, 2026
Downloads: 1,044/mo · 1,044/wk
Author: ravshansbox
License: MIT
Types: extension
Size: 3.7 KB
Dependencies: 0 dependencies · 1 peer

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-notification

OSC 777 terminal notification extension for pi.

Install

pi install npm:@ravshansbox/pi-notification

Add -l to install it in project settings.

Usage

Pi loads the extension from ./index.ts and sends an OSC 777 desktop notification (Pi: Ready) in interactive mode when the agent has finished without being aborted or an extension prompt, such as a question, is waiting for input while the agent is running.

OSC 777 works in terminals such as Ghostty, WezTerm, iTerm2 and rxvt-unicode.

Inside tmux, the sequence is wrapped for passthrough. Enable it in your tmux config:

set -g allow-passthrough on

Development

npm install
npm run check