pi-notify

Pi extension that sends a native terminal notification when the agent finishes and waits for input.

Install

pi install npm:@smoose/pi-notify

Configuration

• PI_NOTIFY_TITLE: notification title template, default π - {project}
• PI_NOTIFY_BODY: notification body template, default {message}
• PI_NOTIFY_MESSAGE_SOURCE: user or assistant, default assistant
• PI_NOTIFY_MESSAGE_MAX: max message characters before ellipsis, default 80, max 500
• PI_NOTIFY_SOUND_CMD: optional shell command run after notification

Kitty uses OSC 99 with o=always. Non-Kitty terminals fall back to macOS AppleScript notifications via osascript. Inside tmux, the active tmux client is checked so stale KITTY_WINDOW_ID values do not force Kitty mode.

When running Kitty inside tmux, enable passthrough:

set -g allow-passthrough all

Template variables:

• {project}: current directory name
• {cwd}: current working directory
• {model}: active model as provider/id
• {model_short}: active model id only
• {message}: selected current-turn message based on PI_NOTIFY_MESSAGE_SOURCE
• {user_message}: current-turn user message, truncated
• {assistant_message}: latest current-turn assistant text, truncated
• {duration}: agent run duration, such as 4.2s
• {duration_ms}: agent run duration in milliseconds

Example:

PI_NOTIFY_TITLE="π - {project}" PI_NOTIFY_BODY="{message}" pi