Your coding agent, now answering to a Telegram chat
A local bridge that lets you drive OpenCode from your phone without opening a single port.

What it does
OpenCode Telegram Bot is a TypeScript client that connects a Telegram chat to the OpenCode CLI running on your own machine. You send prompts from your phone, watch the agent work, approve permissions via inline buttons, and get results back as files. Sessions, models, projects, and even git worktrees are all switchable from the chat.
The interesting bit
The security posture is the quiet star: no open ports, no exposed APIs — the bot talks only to your local OpenCode server and the Telegram Bot API, with a strict user ID whitelist so a discovered bot is still a locked door. Scheduled tasks also turn it into what the author calls a lightweight OpenClaw alternative.
Key highlights
- Live pinned status message showing project, model, context usage, and changed files
- Revert or fork a session from any past message — retry or branch without losing history
- Voice prompts via Whisper-compatible transcription, plus image/PDF/text attachments
- Scheduled recurring tasks (min 5-minute interval, capped at 10 by default)
- Interactive file browser (
/ls) with tap-to-download and attach-to-next-prompt - Localized UI in eight languages; runs on macOS, Windows, and Linux
Caveats
- Scheduled executions always run with the
buildagent — no choosing an agent per task - The README tracks
main, so the npm release may lag behind described features - Requires Node.js 22+ and a locally running OpenCode server
Verdict
If you already use OpenCode and want to kick off builds from the bus, this is a genuinely practical remote. If you don’t use OpenCode, it’s glue you don’t need — well-made glue, but glue.
Frequently asked
- What is grinev/opencode-telegram-bot?
- A local bridge that lets you drive OpenCode from your phone without opening a single port.
- Is opencode-telegram-bot open source?
- Yes — grinev/opencode-telegram-bot is open source, released under the MIT license.
- What language is opencode-telegram-bot written in?
- grinev/opencode-telegram-bot is primarily written in TypeScript.
- How popular is opencode-telegram-bot?
- grinev/opencode-telegram-bot has 1.4k stars on GitHub and is currently holding steady.
- Where can I find opencode-telegram-bot?
- grinev/opencode-telegram-bot is on GitHub at https://github.com/grinev/opencode-telegram-bot.