opencode-gotify-notifier

Send Gotify notifications for Opencode session events.

Features

• Notifications when tasks complete successfully
• Alerts when sessions encounter errors
• Permission request notifications
• Question notifications when agent needs user input
• Session title display in notifications

Installation

Add to your ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-gotify-notifier"]
}

Configuration

Set the following environment variables:

| Variable | Description | Default | |----------|-------------|---------| | GOTIFY_URL | Your Gotify server URL | Required | | GOTIFY_TOKEN | Application token from Gotify | Required | | GOTIFY_TLS_REJECT_UNAUTHORIZED | Set to false to disable TLS verification | true | | GOTIFY_CA_PATH | Path to custom CA certificate (PEM format) | - |

Example:

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

Security

TLS verification is enabled by default for secure connections.

Self-Signed Certificates

If your Gotify server uses a self-signed certificate, you have options:

Option 1: Use a custom CA certificate (recommended)

export GOTIFY_CA_PATH=/path/to/your-ca.pem

Option 2: Disable TLS verification (not recommended for production)

export GOTIFY_TLS_REJECT_UNAUTHORIZED=false

Option 3: Use Node.js environment variable

export NODE_TLS_REJECT_UNAUTHORIZED=0

⚠️ Disabling TLS verification makes your connection vulnerable to man-in-the-middle attacks. Only use this for development or trusted internal networks.

Notification Types

| Event | Title | Priority | |-------|-------|----------| | Task complete | Task Complete | 5 | | Session cancelled | Session Cancelled | 6 | | Permission required | Permission Required | 7 | | Question awaiting input | Question | 7 | | Error | Error | 8 |

Development

# Install dependencies
npm install

# Build
npm run build

# Type check
npm run typecheck

# Lint
npm run lint

# Format
npm run format:fix

Local Testing

To test the plugin locally before publishing:

# Build and deploy to opencode plugins directory
npm run deploy:local

# Or manually:
npm run build
mkdir -p ~/.config/opencode/plugins
cp dist/index.js ~/.config/opencode/plugins/opencode-gotify-notifier.js

Then restart opencode to load the plugin. The plugin file is auto-loaded from ~/.config/opencode/plugins/.

License

MIT