takopi/codex/notify_telegram/readme.md

Notify Telegram (Codex)

Send Codex completion summaries to Telegram with safe Markdown rendering and stable list bullets.

Install

1. Ensure uv is installed.
2. Copy the script to ~/.codex/notify_telegram.py.
3. Create your Telegram creds file at ~/.codex/telegram.toml.

Example:

bot_token = "123456:ABCDEF..."
chat_id = 462722

Configure

Add a notify entry to ~/.codex/config.toml:

notify = ["uv", "run", "-q", "/home/user/.codex/notify_telegram.py"]

Notes

• The script reads last-assistant-message and treats it as Markdown.
• Markdown is rendered to HTML, converted to Telegram text/entities via sulguk, then posted with requests.
• List bullets are normalized from • to - to keep Telegram output consistent.

Files

• notify_telegram.py: the notifier script