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