Willem van den Ende
45a13fd08c
- Add PI_NOTIFICATION_DEBUG=true env var - When enabled, calls ctx.ui.steer() instead of desktop notification - Lets you verify trigger logic in the agent loop without actual notifications - Synced to both monorepo and auto-discovery extension paths
39 lines
818 B
Markdown
39 lines
818 B
Markdown
# pi-notifications
|
|
|
|
Desktop notifications for pi agent events via macOS Notification Center.
|
|
|
|
## What it does
|
|
|
|
Shows a system notification when the agent finishes a turn, so you can step away and get alerted when input is needed.
|
|
|
|
## Configuration
|
|
|
|
| Env var | Default | Description |
|
|
|---------|---------|-------------|
|
|
| `PI_NOTIFICATIONS_ENABLED` | `true` | Set to `false` to disable all notifications |
|
|
| `PI_NOTIFICATION_AGENT_END` | `true` | Notification when agent finishes |
|
|
| `PI_NOTIFICATION_TITLE` | `pi` | Notification title |
|
|
| `PI_NOTIFICATION_SOUND` | `default` | macOS sound (Bottle, Ping, Pop, etc.) or `""` for silent |
|
|
|
|
## Usage
|
|
|
|
Add to `~/.pi/agent/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"packages": [
|
|
"/path/to/packages/pi-notifications"
|
|
]
|
|
}
|
|
```
|
|
|
|
Then reload pi:
|
|
|
|
```bash
|
|
/reload
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|