← all repositories
grinev/opencode-telegram-bot

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.

★1.4k stars TypeScript Coding AssistantsAgents
opencode-telegram-bot
Velocity · 7d
+2.0
★ / day
Trend
→steady
star history

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 build agent — 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.