Telegram Sender

Use the bundled script for Telegram delivery:

python3 /Users/tec/.codex/skills/telegram-sender/scripts/send_telegram.py --message "done"
python3 /Users/tec/.codex/skills/telegram-sender/scripts/send_telegram.py --file /absolute/path/to/file --caption "artifact"

Configuration

Token lookup order:

1. TELEGRAM_BOT_TOKEN
2. macOS Keychain service codex-telegram-bot-token

Chat lookup order:

1. TELEGRAM_CHAT_ID
2. macOS Keychain service codex-telegram-chat-id
3. --discover-chat after the user has sent any message to the bot

Save values to Keychain:

security add-generic-password -a "$USER" -s codex-telegram-bot-token -w "$TELEGRAM_BOT_TOKEN" -U
security add-generic-password -a "$USER" -s codex-telegram-chat-id -w "$TELEGRAM_CHAT_ID" -U

Workflow

1. For short text, use --message.
2. For longer command output, pipe stdin:

some-command | python3 /Users/tec/.codex/skills/telegram-sender/scripts/send_telegram.py --message -

1. For artifacts, use --file /absolute/path and include a concise --caption.
2. If sending screenshots or generated images, add --photo so Telegram renders them inline.
3. If chat id is missing, ask the user to message the bot once, then run:

python3 /Users/tec/.codex/skills/telegram-sender/scripts/send_telegram.py --discover-chat --save-discovered-chat

Safety

• Never print, paste, or include the bot token in user-facing output.
• Do not send credentials, private keys, cookies, or sensitive logs unless the user explicitly requests that exact send.
• When a file may contain secrets, inspect or summarize it first and ask before sending.
• Prefer concise notifications over dumping huge logs into Telegram.