feat: add telegram notifier

2025-12-28 18:48:20 +04:00
commit 75fa95752f
5 changed files with 108 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 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:
+
+```json
+{
+  "bot_token": "123456:ABCDEF...",
+  "chat_id": "462722"
+}
+```
+
+## Configure
+
+Add a `notify` entry to `~/.codex/config.toml`:
+
+```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