What problem does it solve?
This skill eliminates tedious manual Telegram administration by providing a robust Telethon-based wrapper with Claude Code integration. It enables automated messaging, media handling, drafts, and a daemon-driven flow that can spawn per-chat Claude sessions and persist state across restarts, reducing repetitive tasks and improving consistency.
Core Features & Use Cases
- Message Operations: Send, receive, search, edit, and delete messages
- Draft Management: Create, update, list, and send drafts
- Media Operations: Download media, transcribe voice messages
- Daemon Mode: Background monitoring with per-chat Claude sessions and queued handling
- Session Persistence: Claude sessions survive restarts and resume per chat
- Obsidian Integration: Append messages to daily notes or person notes for knowledge capture
Quick Start
- Interactive setup: python3 scripts/tg.py setup
- Non-interactive setup: python3 scripts/tg.py setup --api-id YOUR_API_ID --api-hash YOUR_API_HASH --phone +YOUR_PHONE
- Check connection status: python3 scripts/tg.py status
- List chats: python3 scripts/tg.py list
- Start daemon (foreground): python3 scripts/tgd.py start --foreground