pi-gotify-notifier

Send Gotify push notifications for pi agent session events.

Features

• Task Complete — notified when the agent finishes processing and is waiting for your input
• Session Ended — notified when the pi session shuts down
• Context Warning — notified when context usage reaches configurable thresholds (50%, 75%, 90%, 95%)
• Toggle on/off — enable or disable all notifications or individual types with the interactive /gotify settings panel
• Editable thresholds — add, remove, or reset context warning thresholds directly from the settings menu

Installation

Via npm

pi install npm:pi-gotify-notifier

Via git

pi install git:github.com/mario-gc/pi-gotify-notifier@main

Local development

pi -e ./path/to/pi-gotify-notifier/src/index.ts

Configuration

Set the following environment variables before starting pi:

| Variable | Required | Description | |---|---|---| | GOTIFY_URL | Yes | Your Gotify server URL (e.g., https://gotify.example.com) | | GOTIFY_TOKEN | Yes | Gotify application token | | GOTIFY_ENABLED | No | Set to false or 0 to disable the entire extension at startup (no config loaded, no notifications sent) | | GOTIFY_STARTUP_DISABLED | No | Set to true or 1 to load the extension but start with notifications disabled (can be enabled later via /gotify) | | GOTIFY_TLS_REJECT_UNAUTHORIZED | No | Set to false or 0 to disable TLS verification | | GOTIFY_CA_PATH | No | Path to a custom CA certificate file | | GOTIFY_CONTEXT_THRESHOLDS | No | Comma-separated context usage percentages to warn at (default: 50,75,90,95) | | NODE_TLS_REJECT_UNAUTHORIZED | No | Fallback for TLS verification (if GOTIFY_TLS_REJECT_UNAUTHORIZED is not set) |

Example

export GOTIFY_URL="https://gotify.example.com"
export GOTIFY_TOKEN="your-app-token"
pi

How It Works

The extension listens to pi's lifecycle events:

| Event | Notification | Priority | |---|---|---| | agent_end | ✅ Task Complete | 5 | | agent_end | 🚨 Context Warning (at threshold) | 8 | | session_shutdown | 🔴 Session Ended | 3 |

Thresholds reset after each new session and after compaction.

Notifications are debounced — if multiple agent turns complete in quick succession, only one notification is sent after a short delay.

If the required environment variables are not set, the extension loads silently and does nothing.

Commands

| Command | Description | |---|---| | /gotify | Open interactive notification settings |

Type /gotify to open a settings panel where you can:

• Toggle all notifications on/off
• Toggle individual notification types (Task Complete, Context Warning, Session Ended)
• Send a test notification
• Add, remove, or reset context warning thresholds (e.g., 50%, 75%, 90%, 95%)

Notification state persists across agent turns and survives /reload within the same session.

License

MIT