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 /Users/name/.codex/notify_telegram.py.
3. Create your Telegram creds file at /Users/name/.codex/telegram.json.

Example:

{
  "bot_token": "123456:ABCDEF...",
  "chat_id": "462722"
}

Configure

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

notify = ["uv", "run", "/Users/name/.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