momolm/codex-mainline

Codex Mainline is a bridge that connects OpenAI's Codex CLI tool to Telegram, so you can control a running Codex session from your phone or desktop via chat messages. Codex is a command-line tool that can write and run code, operate files, and execute tasks on your computer. This project keeps a single persistent Codex session alive over time and routes your Telegram messages into it, then relays Codex's responses back to Telegram. The bridge runs on Windows and connects to Codex using the official Codex app-server websocket interface. It is not a reverse proxy or an unofficial imitation of Codex. On the Telegram side it uses a standard bot setup: you create a bot through Telegram's BotFather tool, configure it in the project settings, and restrict access to your own chat ID so only you can talk to it. You can send text, images, and files through Telegram and they get forwarded into the Codex conversation. File delivery in the other direction works too. Several bridge-level commands are available that do not get passed to Codex, including commands to check status, set effort level, switch language, manage sessions, and stop the process. The bridge handles a situation called context compaction (when a conversation gets too long and needs to be summarized) by queuing incoming messages, notifying you via Telegram when compaction starts and finishes, and recovering gracefully if it fails. A watchdog process monitors the bridge and restarts it if it crashes. An optional rhythm feature can send periodic wake messages to prompt Codex to check in or take action on its own. Setup requires Node.js 22 or newer, the Codex CLI, and a Telegram bot token. Windows batch files are included for one-click start and stop. The project supports English and Chinese output and stores all runtime state and logs locally. Credentials and logs are excluded from the repository.