GitHub - Davasny/opencode-telegram-notification-plugin

2 min read Original article ↗

OpenCode Telegram Notification Plugin

Get notified on Telegram when your OpenCode sessions complete.

Installation

  1. Start a chat with @opencodetelegramnotificationbot
  2. Send /start
  3. Run the command the bot sends you
  4. Done!

Commands

Command Description
/start Get installation command
/revoke Generate new key (invalidates old one)
/status Check installation status
/help Show help message

How It Works

  1. The bot generates a unique installation key for you
  2. The installation script configures the plugin with your key
  3. When OpenCode finishes a task, the plugin notifies the bot
  4. The bot sends you a Telegram message

Your Telegram chat ID is never stored in the plugin — only a revocable key.

Uninstall

rm ~/.config/opencode/plugin/telegram-notify.js

Optionally, send /revoke to the bot to invalidate your key.

Security

  • Your chat ID never leaves the server
  • You can revoke your key anytime with /revoke
  • The plugin only contains a UUID key, not your chat ID

Development

Prerequisites

  • Node.js 22+
  • pnpm 10+
  • Cloudflare account
  • Telegram Bot Token (from @BotFather)

Setup

# Install dependencies
pnpm install

# Create KV namespace
wrangler kv namespace create "USERS"

# Add KV ID to worker/wrangler.jsonc

# Set bot token
wrangler secret put BOT_TOKEN

# Start local development
pnpm dev

Manual Deployment (from localhost)

# 1. Login to Cloudflare (first time only)
cd worker && pnpm exec wrangler login

# 2. Create KV namespace (first time only)
pnpm exec wrangler kv namespace create "USERS"
# Copy the ID and update worker/wrangler.jsonc

# 3. Deploy the worker
pnpm exec wrangler deploy

# 4. Set the BOT_TOKEN secret (first time or when rotating token)
pnpm exec wrangler secret put BOT_TOKEN
# Paste your bot token when prompted

# 5. Set Telegram webhook (first time only)
curl "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://opencode-telegram-bot.<your-subdomain>.workers.dev/webhook"

To redeploy after changes, just run:

cd worker && pnpm exec wrangler deploy

Set Webhook

After deployment, set the Telegram webhook:

curl "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://opencode-telegram-bot.<subdomain>.workers.dev/webhook"