gitwtfhub

wtf is codex-telegram-bot?

artickc/codex-telegram-bot — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TL;DR

A Telegram bot that lets you control the OpenAI Codex CLI coding assistant from your phone, with project switching, session resume, and scheduled prompts.

Mindmap

mindmap
  root((Codex Telegram Bot))
    What it does
      Chat with Codex via Telegram
      Stream diffs and progress
      Schedule recurring prompts
    Tech stack
      TypeScript
      Node.js
      Codex app-server
    Use cases
      Code from your phone
      Resume past sessions
      Run as 24 7 service
    Audience
      Codex CLI users
      Vibe coders
    Setup
      Node.js 20 plus
      Codex CLI login
      Telegram bot token

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Send coding prompts to Codex from your phone via Telegram instead of a terminal.

REASON 2

Resume a previous Codex coding session from any device with Telegram installed.

REASON 3

Schedule a recurring prompt, like a daily code review, delivered back to your chat.

REASON 4

Run Codex as a 24/7 background service that survives reboots on your machine.

What's in the stack?

TypeScriptNode.jsgrammYCodex CLIJSON-RPC

How it stacks up

artickc/codex-telegram-bot0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires the OpenAI Codex CLI already installed and logged in, plus a Telegram bot token from BotFather.

MIT license: free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Explain how Codex Telegram Bot bridges Telegram messages to a running codex app-server process.
Prompt 2
Walk me through installing codex-telegram-bot with npm and setting up my .env file.
Prompt 3
Show me how to schedule a recurring Codex task using the /newtask command.
Prompt 4
Help me set up multiple Codex accounts with automatic quota rotation in this bot.

Frequently asked questions

wtf is codex-telegram-bot?

A Telegram bot that lets you control the OpenAI Codex CLI coding assistant from your phone, with project switching, session resume, and scheduled prompts.

What language is codex-telegram-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, grammY.

What license does codex-telegram-bot use?

MIT license: free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-telegram-bot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-telegram-bot for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.