# TelegramCode

A tool that turns a Telegram bot or group into a terminal for running OpenCode and Claude Code, so each conversation thread acts like a terminal tab you can drive from your phone by voice or text.

A topic is bound to a project folder and an agent; two topics can share a folder for parallel work, and a raw terminal command binds a topic to a real shell in the project folder. It serves both forum-group topics and the bot owner's direct messages at once.

The bot pins a message when the agent asks a question, so even a muted topic gets exactly one notification, and a schedule command arms cron, one-shot or repeated jobs per topic; the agent can also schedule itself through injected MCP tools for things like nightly reviews. Photos, documents, video and audio sent to a topic are saved and passed to the agent, and the agent can send files back, including generated charts, screenshots or rendered PDFs.

It runs self-hosted on the user's own machine or VPS with no open ports required, and transcribes voice input through Whisper via Groq or OpenAI.

Website: https://github.com/olosegres/telegramcode