explaingit

artickc/opencode-telegram-bot

Analysis updated 2026-05-18

7TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Telegram bot that lets you remotely control and monitor the OpenCode AI coding assistant running on your computer.

Mindmap

mindmap
  root((opencode-telegram-bot))
    What it does
      Remote control OpenCode
      Live session watching
      Tool call visibility
    Tech stack
      TypeScript
      Node.js
      Telegram Bot API
    Use cases
      Mobile coding control
      Scheduled prompts
      Session kill by PID
    Audience
      OpenCode users
      Remote developers
      Automation enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Send coding tasks to OpenCode from your phone and watch it edit files in real time.

USE CASE 2

Resume or watch live OpenCode sessions running on your PC from Telegram.

USE CASE 3

Schedule recurring prompts to run automatically in a chosen project.

USE CASE 4

Kill a runaway OpenCode session remotely by its process ID.

What is it built with?

TypeScriptNode.jsTelegram Bot APIOpenCode ACP

How does it compare?

artickc/opencode-telegram-botadguardteam/ruleseditorbymilon/aether-nexus-dashboard
Stars777
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-01
MaintenanceActive
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js, an existing OpenCode installation, and a Telegram bot token.

MIT license: free to use, modify, and share, including commercially, as long as the copyright notice stays attached.

In plain English

This project lets you control OpenCode, an AI coding assistant, from Telegram on your phone. It connects to OpenCode using its Agent Client Protocol and turns your phone into a remote control for a coding assistant running on your own computer. You send a message from anywhere, and the bot relays it to OpenCode, which can then plan out work, read files, run commands, and edit code on your machine, sending the results back to your chat as they happen. The bot supports switching between different project folders, resuming past coding sessions, and even watching or joining sessions that are already running live on your PC. You can stop a specific running session by its process ID, or stop them all at once. While a task runs, a pinned status panel shows which project, model, and session is active, along with a live progress bar. File edits are shown as readable diffs, and every tool the assistant uses, such as searching files, running shell commands, or calling other connected tools, gets its own clearly formatted card in the chat, along with a status icon showing whether it succeeded or failed. Other features include scheduling prompts to run automatically on a timer, sending multiple photos with a prompt for the assistant to look at, queuing follow-up messages while it is busy, voice message transcription, and access restricted to specific Telegram user accounts you approve. The bot can also install itself as a background service so it keeps running after a reboot, on Windows, Linux, or macOS. This is aimed at developers who already use OpenCode and want to check on or direct their coding assistant while away from their desk. It requires Node.js, an OpenCode installation, and a Telegram bot token to set up, and it is a fork of an earlier project called kiro-telegram-bot rebuilt for OpenCode. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up opencode-telegram-bot with a Telegram bot token and connect it to OpenCode.
Prompt 2
Explain how to install opencode-telegram-bot as a 24/7 background service on Linux.
Prompt 3
Walk me through restricting bot access to only my Telegram user ID.
Prompt 4
Show me how the scheduled tasks feature works for running recurring prompts.

Frequently asked questions

What is opencode-telegram-bot?

A Telegram bot that lets you remotely control and monitor the OpenCode AI coding assistant running on your computer.

What language is opencode-telegram-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Telegram Bot API.

What license does opencode-telegram-bot use?

MIT license: free to use, modify, and share, including commercially, as long as the copyright notice stays attached.

How hard is opencode-telegram-bot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is opencode-telegram-bot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.