Pi Coding Agent Notifications

VS Code extension that shows macOS notifications when the Pi Coding Agent is waiting for input and the terminal is not focused.

Example macOS notification from Pi

Features

Native macOS notifications when Pi finishes a turn and the terminal is not visible.
Click a notification to focus the owning VS Code window and terminal.
Notifications auto-dismiss when you switch to the terminal yourself.
Grouped per terminal — new notifications replace stale ones.

macOS — this extension uses native macOS notifications and is not available on other platforms.
pi-vscode-terminal-notification — companion Pi package that emits notifications when Pi finishes a turn. Without it, this VS Code extension has nothing to listen for.

Install the companion Pi package:

pi install pi-vscode-terminal-notification

The Pi extension writes an OSC 777 notify escape sequence to the terminal when Pi finishes a turn.
This VS Code extension reads the terminal output stream and parses OSC 777 sequences (including tmux passthrough-wrapped ones).
If the terminal is not focused, a native macOS notification is shown. Clicking it brings the VS Code window and terminal to the foreground.

Notification permissions — open System Settings → Notifications, find pi-terminal-notifier, and enable Allow Notifications.
Pi extension not installed — this VS Code extension only listens; install the Pi package via pi install pi-vscode-terminal-notification.
Terminal is focused — notifications are intentionally suppressed when the Pi terminal is already visible and focused.

Logs are written to the "Pi Terminal Notify" output channel — open it via Command Palette → Output: Show Output Channel → Pi Terminal Notify.

Derived from Pan Wenbo's vscode-terminal-osc-notifier (MIT).