@jingoz/pi-win-notify
v0.1.0
Published
Windows-only Pi TUI task completion Toast
Maintainers
Readme
@jingoz/pi-win-notify
A Windows-only Pi TUI extension that sends one Windows Toast when Pi has fully settled and is ready for input.
Install
pi install npm:@jingoz/pi-win-notifyBehavior
- Listens to Pi's
agent_settledevent, so automatic retries, compaction retries, and queued continuations do not cause premature notifications. - Only works on Windows (
process.platform === "win32") and in TUI mode. RPC, JSON, print, Linux, and macOS stay inert. - Displays exactly:
Pi
Task completed · <current directory basename>- Uses
powershell.exeto call the Windows Runtime Toast API. No third-party runtime dependency or resident helper is used. - Each Pi process sends its own Toast on each settled task. There is no duration threshold, focus detection, deduplication, or cross-process state.
- Prompts, responses, session names, full paths, process IDs, timestamps, images, buttons, and notification actions are never included.
- Sound, display duration, suppression, grouping, and notification-center retention follow Windows settings.
- Toast failures are contained and never affect Pi or fall back to another notification mechanism.
Local Development
pnpm --filter @jingoz/pi-win-notify check
pnpm --filter @jingoz/pi-win-notify test
pnpm install --frozen-lockfile --offline
pi --no-extensions -e ./packages/win-notify --list-modelsAutomated tests cover the Windows TUI happy path, exact Toast content, one notification per settlement, platform/mode isolation, PowerShell-sensitive directory basenames, and failure containment.
A real visual Windows TUI smoke remains manual verification: load the package in a Windows TUI Pi session, complete one agent run, and confirm the system Toast appears.
