opencode-telegram-bot

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.