Telegram Codex Bridge v0.3.1
Telegram Codex Bridge v0.3.1
Telegram Codex Bridge lets a private Telegram bot act as a second client for a
Codex Desktop task on Windows.
Highlights
- Add a safe Restart Telegram Codex Bridge recovery shortcut and make
npm run servicerepair the complete managed host instead of launching only
the Telegram poller. - Refuse installation while Codex Desktop is still running, before changing
any bridge or Desktop environment settings. - Relaunch the managed Telegram poller within seconds if it is killed, with a
bounded crash-loop fallback to Windows Task Scheduler. - Report live app-server health and Desktop connectivity in the status tool.
- Keep using the normal Codex Desktop interface while Telegram is connected.
- Plain Telegram messages automatically start a turn when idle or steer the
active turn while Codex is working. - Use
/fresh,/steer, and/queuewhen you want explicit delivery behavior. - Send images and files in either direction.
- Move one shared bot between tasks, or configure separate dedicated bots for
simultaneous task access. - Run silently at Windows logon with a bundled Node.js LTS runtime.
- Store Telegram bot tokens in the current Windows user's DPAPI-encrypted local
data instead of source files, command lines, or Git.
Install
Download TelegramCodexBridgeSetup.exe, verify it against SHA256SUMS.txt,
and run the installer. Setup guides you through entering a freshly generated
BotFather token in a masked local prompt and pairing your Telegram account.
Fully quit and reopen Codex Desktop once after installation.
Important beta notes
- Windows x64 only.
- The installer is not yet code-signed, so Windows may display an Unknown
Publisher or SmartScreen warning. Verify the SHA-256 before running it. - Telegram-triggered Codex turns use Full Access with approval policy
never.
Only pair a private bot and Telegram account you control.
See the repository README for configuration, recovery, security boundaries,
uninstall instructions, and example linking prompts.