Skip to content

OpenCode Telegram Bot

by Ruslan GrinevAppWrite code

Lets you send coding tasks to OpenCode on your computer from Telegram on your phone

View on GitHub

The problem it solves

You left a coding task running at your desk, and now you're out with only your phone and no way to see whether it is stuck on a question.

For OpenCode usersDevelopers away from their desk

Before
You walk back to your computer to check progress, answer a permission prompt or type the next instruction.
After
You chat with OpenCode in Telegram: it works on your computer, asks questions with buttons and sends back progress and changed files.
Stars
★ 1.3k
License
MIT
Cost
Usage-based
Platforms
Mac · Win · Linux
Runs
Local

Screenshots

From the project's own repository · 3 images, swipe or use the arrows.

A Telegram chat where the bot reads a file, edits it and reports that comments were added
Choosing a project and starting a new session, with a pinned status of the model, context and changed files
Switching the model from a list of buttons in the Telegram chat
Image: Ruslan Grinev (MIT). Original file

Overview

OpenCode Telegram Bot is a Telegram chat bot that connects to the OpenCode coding agent running on your own computer. You type a task in Telegram; OpenCode does the work on your computer and the bot sends back its progress, questions and changed files. You can switch projects, sessions and models, approve permissions with buttons and schedule tasks to run later. It suits OpenCode users who want to keep work going while away from their desk.

It runs on your own computer and answers only the Telegram user ID you set; the maker says it opens no ports.

Try these first

Start with the first one: it is a small task you can check easily.

  1. /statusFirst try · read-only

  2. Explain what [file name] does. Don't change any files.read-only

  3. Add comments to [file name] and send me the changed file.edits files

  4. Every morning at 9, check this project for failing tests and tell me what you find.scheduled task

Example prompts written by Agent Flows Hub.

Features

From the creator's documentation.

FeatureWhat it doesRuns
Remote promptsSend text, images or files from Telegram to OpenCode on your computer; voice needs a transcription serviceTelegram + your computer
Live statusA pinned message with project, model, context use and changed filesRead
ApprovalsAnswer the agent's questions and permission requests with buttonsRead + write
Sessions and modelsCreate, continue, revert or fork sessions and switch models or projectsYour computer
Scheduled tasksRun prompts later or on a repeating interval of 5 minutes or moreYour computer
Access controlOnly the Telegram user ID you set can use the botTelegram

Good to know

You start a coding task in OpenCode and want to follow it, answer its questions and send the next prompt from your phone. The bot relays prompts, status, permission requests and changed files between Telegram and the OpenCode server on your computer.

Limits

  • The bot and OpenCode both run on your computer, so that computer has to stay on and connected. OpenCode V1 and V2 use different server settings, and the bot does not detect the version on its own.
  • Custom local commands you add run with the bot's own permissions on your computer. Add only commands you wrote or have read.

Notes by (original project name: opencode-telegram-bot), written from the creator's documentation, not from running it ourselves. OpenCode Telegram Bot: README and quick start

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

Other apps

  • OpenCreator Translates and dubs videos, writes scripts and posts, and makes images and videos
  • OpenDesign Turns a short brief into web prototypes, slide decks, images and motion graphics
  • OpenFilm Lets your coding agent make animated videos that you can then change by hand in an editor
  • OpenKnowledge Lets you edit local notes and wikis like Notion pages, with Claude or Codex alongside
  • OpenMausBot Lets you run a team of AI bots in a chat app, each with its own model, computer and apps
  • OpenPencil Lets you describe a web page or app screen and watch an AI draw the design on a canvas

See all 113 apps

GitHub