opencode-telegram-bot

OpenCode mobile client via Telegram: run and monitor AI coding tasks from your phone while everything runs locally on your machine. OpenCode V2 support.

What is opencode-telegram-bot?

OpenCode mobile client via Telegram: run and monitor AI coding tasks from your phone while everything runs locally on your machine. OpenCode V2 support.

Overview of opencode-telegram-bot

What it is

OpenCode Telegram Bot is a Telegram client for OpenCode CLI that runs on your local machine. It allows you to run AI coding tasks, monitor progress, switch models, and manage sessions from your phone. The bot communicates with your local OpenCode server and the Telegram Bot API only, with no open ports or exposed APIs. It supports macOS, Windows, and Linux.

Key features

  • OpenCode V2 support — works with both OpenCode V2 and classic V1.
  • Remote coding — send prompts to OpenCode from anywhere, receive results with code sent as files.
  • Session management — create new sessions or continue existing ones.
  • Live status — pinned message with current project, model, context usage, and changed files list, updated in real time.
  • Model switching — pick models from OpenCode favorites and recent history, or browse all models by provider.
  • Scheduled tasks — schedule prompts to run later or on a recurring interval.
  • Voice prompts — send voice/audio messages, transcribe via a Whisper-compatible API.
  • File attachments — send images, PDF documents, and text-based files to OpenCode.
  • Security — strict user ID whitelist; no one else can access your bot.
  • Localization — UI localization supported for multiple languages (English, Arabic, German, Spanish, French, Indonesian, Italian, Korean, Portuguese, Russian, Turkish, Chinese Simplified).

Use cases

  • Run AI coding tasks from your phone while the code runs locally on your machine.
  • Monitor live progress of OpenCode CLI sessions remotely.
  • Schedule prompts to run later or on a recurring basis.
  • Manage multiple sessions, switch models, and interact with agent questions via Telegram.

Getting started

Prerequisites: Node.js 22.14+, OpenCode installed, and a Telegram Bot token from @BotFather. Quick start with npx: bash npx @grinev/opencode-telegram-bot@latest Alternatively, install globally: bash npm install -g @grinev/opencode-telegram-bot opencode-telegram start The bot will guide you through configuration interactively if not provided via environment variables or .env file.

License and pricing

This project is open source under the MIT license. No pricing information is stated; it is free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/grinevopencode-telegram-bot.svg)](https://yunodb.com/tools/grinevopencode-telegram-bot?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/grinevopencode-telegram-bot?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/grinevopencode-telegram-bot.svg" alt="Featured on YunoDB" height="20"></a>