@waraq-labs/pi-notify-terminal-notifier

Pi extension: sends macOS notification-notifier notifications when agent waits for input

Package details

extension

Install @waraq-labs/pi-notify-terminal-notifier from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@waraq-labs/pi-notify-terminal-notifier

Package: @waraq-labs/pi-notify-terminal-notifier
Version: 1.0.2
Published: Feb 15, 2026
Downloads: 20/mo · 11/wk
Author: jibranahmed
License: MIT
Types: extension
Size: 6.7 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-notify-terminal-notifier

pi-notify-terminal-notifier is a Pi extension that sends native macOS desktop notifications when the agent is waiting for your input.

It is especially useful when running Pi inside multiplexers like Zellij, where notification escape sequences are not always forwarded.

Why this exists

Many existing terminal notification tools rely on OSC 777 (or OSC 9). In Zellij, those OSC sequences are not passed through to the underlying terminal, so desktop notifications never fire.

Zellij discussion: https://github.com/zellij-org/zellij/issues/3954

This extension avoids OSC-based notifications and invokes terminal-notifier directly, so notifications still work in that setup.

Requirements

macOS
terminal-notifier available in PATH
- Install with: brew install terminal-notifier

Install

From npm

pi install npm:@waraq-labs/pi-notify-terminal-notifier

From GitHub

pi install git:github.com/<you>/<repo>@v0.x

Local development / test

pi -e /absolute/path/to/pi-notify-terminal-notifier
# or
pi install /absolute/path/to/pi-notify-terminal-notifier

Maintenance

This project is actively maintained.