takopi/codex_telegram_bridge

Telegram Codex Bridge (Codex)

Route Telegram replies back into Codex sessions using non-interactive codex exec + codex exec resume.

The bridge stores a mapping from (chat_id, bot_message_id) to a route so replies can be routed correctly.

Install

1. Ensure uv is installed.
2. From this folder, run the entrypoints with uv run (uses pyproject.toml deps).
3. Put your Telegram credentials in ~/.codex/telegram.toml.

Example ~/.codex/telegram.toml:

bot_token = "123:abc"
chat_id = 123456789

chat_id is used both for allowed messages and startup notifications.

Optional keys:

• exec/resume: codex_cmd, codex_workspace, codex_exec_args, max_workers

Option 1: exec/resume

Run:

uv run exec-bridge

Optional flags:

• --progress-edit-every FLOAT (default 2.0)
• --progress-silent/--no-progress-silent (default silent)
• --final-notify/--no-final-notify (default notify via new message)
• --ignore-backlog/--process-backlog (default ignore pending updates)
• --workdir PATH (override codex_workspace)
• --model NAME (pass through to codex exec)

To resume an existing thread without a database, reply with (or include) the session id shown at the end of the bot response:

resume: \019b66fc-64c2-7a71-81cd-081c504cfeb2``

Files

• src/codex_telegram_bridge/constants.py: limits and config path constants
• src/codex_telegram_bridge/config.py: config loading and chat-id parsing helpers
• src/codex_telegram_bridge/exec_render.py: renderers for codex exec JSONL events
• src/codex_telegram_bridge/rendering.py: markdown rendering
• src/codex_telegram_bridge/telegram_client.py: Telegram Bot API client
• src/codex_telegram_bridge/exec_bridge.py: codex exec + resume bridge