# 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