opencode-ntfy

OpenCode plugin that sends push notifications via ntfy when tasks complete or errors occur.

Install

Add to your opencode.json:

{
  "plugin": ["opencode-ntfy"]
}

Configure

Create .opencode-ntfy.json in your project root:

{
  "topic": "my-opencode-notifications"
}

| Field | Required | Default | Description | |----------|----------|--------------------------------------|------------------------| | topic | yes | -- | ntfy topic name | | server | no | https://ntfy.sh | ntfy server URL | | events | no | ["session.idle", "session.error"] | events to notify about |

Self-hosted ntfy

{
  "server": "https://ntfy.example.com",
  "topic": "my-topic"
}

Only error notifications

{
  "topic": "my-topic",
  "events": ["session.error"]
}

Events

| Event | Title | Priority | |-----------------|--------------------------|----------------| | session.idle | opencode: task complete | 3 (default) | | session.error | opencode: error | 4 (high) |

Receiving notifications

Subscribe to your topic with any ntfy client:

• Phone: ntfy Android / iOS
• Desktop: curl -s ntfy.sh/my-topic/sse
• Browser: https://ntfy.sh/my-topic

License

GPL-3.0-or-later