@xiaoso/pi-plugin-windows-notify
Pi Windows notification plugin - sends notifications on task completion and user confirmation needed, with AFK mode to notify only when away from window
Package details
Install @xiaoso/pi-plugin-windows-notify from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@xiaoso/pi-plugin-windows-notify- Package
@xiaoso/pi-plugin-windows-notify- Version
0.0.2- Published
- May 22, 2026
- Downloads
- 305/mo · 7/wk
- Author
- xiaoso
- License
- MIT
- Types
- extension
- Size
- 37.6 KB
- Dependencies
- 2 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
简体中文 | English
pi-windows-tip
A pi extension that sends Windows desktop notifications when tasks complete, fail, or need your confirmation — so you can step away and come back when Pi needs you.
⚠️ Windows only — this extension uses Windows-specific APIs and will not work on other platforms.
Compatible with both Pi and OMP (Oh My Pi).
Features
- Task completion / failure / confirmation-request notifications
- AFK mode — only notify when you're away from the Pi window
- Minimum task duration filter (skip trivially short tasks)
- 7 languages (en, zh-CN, ja, ko, es, fr, ru) — auto-detected from system locale
- Persistent settings across sessions
Install
Pi:
pi install npm:@xiaoso/pi-plugin-windows-notify
OMP:
omp plugin install @xiaoso/pi-plugin-windows-notify
Or from git:
pi install git:github.com/xiaoso456/pi-plugin-windows-notify
Commands
/notify — open notification settings
Settings
| Setting | Values | Description |
|---|---|---|
| Enabled | on / off | Master switch |
| Notify Mode | afk / all | afk: only notify when away; all: always notify |
| Language | en / zh-CN / ja / ko / es / fr / ru | Display language |
Config file (Pi): ~/.pi/agent/pi-windows-tip-config.json
Config file (OMP): ~/.omp/agent/pi-windows-tip-config.json
How it works
Listens to Pi lifecycle events and sends notifications via node-notifier. In AFK mode, active-win checks whether the foreground window is still Pi — notifications are suppressed while you're watching.
License
MIT