opencode-telegram

Telegram bot bridge for remote control of OpenCode CLI on Linux.

Install

Published package:

npm install -g @royhk920/opencode-telegram

Then run the setup wizard:

opencode-telegram-install

Start the bot:

opencode-telegram

What It Does

• Sends prompts from Telegram to OpenCode
• Streams model responses back to Telegram
• Supports session management and model selection
• Supports file uploads
• Supports background cron jobs
• Supports optional MemPalace cron job actions if the related scripts are configured

Runtime Paths

The npm/global install stores data in user paths instead of inside node_modules:

• Config: ~/.config/opencode-telegram/config.json
• Data: ~/.local/share/opencode-telegram/
• Env token: ~/.config/opencode/opencode-telegram.env

The bot also supports legacy fallback to a repo-local config.json if present.

Configuration

Example config:

{
    "telegram": {
        "token": "PASTE_YOUR_BOT_TOKEN_HERE",
        "allowedUsers": [0],
        "adminChatId": 0
    },
    "opencode": {
        "host": "127.0.0.1",
        "port": 4096,
        "password": ""
    },
    "defaults": {
        "model": "",
        "agent": "build",
        "thinking": "",
        "autoSummarizeTokenThreshold": 120000
    },
    "cron": {
        "enabled": false,
        "jobs": []
    }
}

You can store the Telegram token in either:

• ~/.config/opencode-telegram/config.json
• ~/.config/opencode/opencode-telegram.env as TELEGRAM_BOT_TOKEN=...

OpenCode Setup

Install OpenCode:

npm install -g opencode-ai

Make sure the OpenCode server is available. The bot expects:

• host: 127.0.0.1
• port: 4096

Default OpenCode config example:

{
  "mcp": {},
  "$schema": "https://opencode.ai/config.json",
  "permission": "allow"
}

Commands

• /help show help
• /new create a new session
• /list list sessions
• /switch N switch session
• /delete N delete session
• /model select model
• /agent select agent
• /status show connection and token info
• /summarize compact current session
• /thinking set thinking level
• /review run OpenCode review
• /stop stop current task and clear queue
• /clear clear queued messages
• /cron manage cron jobs
• /restart restart bot or services
• /file path read a file
• /find pattern search files
• /grep text search file contents
• /shell cmd run a shell command
• /project show project info

Systemd

The repo includes:

• opencode-telegram.service
• opencode-server.service

For clone-based Linux installs you can still use:

./install.sh

Development

Run tests:

npm test

Dry-run package check:

npm pack --dry-run