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 into your repo (already in this folder).
3. Create your Telegram creds file at ~/.codex/telegram.json.

Example:

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

Configure

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

notify = ["uv", "run", "/absolute/path/to/agents/codex/notify_telegram/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
• telegram.json.example: sample credentials file
• config.toml.example: sample Codex notify config line