artickc/codex-telegram-bot

Codex Telegram Bot lets you control OpenAI's Codex CLI, an AI coding assistant, from a Telegram chat instead of a terminal. Once set up, you can message the bot from your phone or anywhere Telegram works, and it relays that message to Codex running on your own machine, letting the AI read files, run commands, and edit code while you watch the results appear as chat messages. The bot supports switching between different project folders, resuming earlier coding sessions, and viewing recent conversation history, all through simple slash commands. It shows a persistent menu and a status panel so you always know which project, model, and session you are working in. You can schedule prompts to run automatically on a repeating basis, such as daily or weekly, with the results delivered back to your chat. It also accepts photos, voice notes that get transcribed into text, and file attachments as part of a prompt. File edits made by Codex are shown as readable diffs with clear plus and minus line counts, and long agent responses are converted into clean Telegram formatted text. If you send a message while Codex is busy with something else, it gets queued and runs automatically once the current task finishes. The bot can also manage multiple Codex accounts, switching between saved logins automatically if one hits a usage limit. Under the hood, the bot starts a single codex app-server process and talks to it using a JSON based protocol over standard input and output. That one process can handle many separate chat threads at once, streaming back text, reasoning steps, and tool actions as they happen. To use it, you need Node.js 20 or later, the OpenAI Codex CLI installed and logged in, a Telegram bot token from BotFather, and your own Telegram user id. Installation is a single npm command that sets up a global command line tool, which can then run in the foreground or install itself as a background service that starts automatically on boot across Windows, Linux, and macOS. The project is released under the MIT license.