What problem does it solve?
Enables reliable, automated Telegram interactions and background monitoring so you can respond, transcribe, and run Claude Code sessions per chat without manual supervision or repetitive CLI steps.
Core Features & Use Cases
- Daemon-mode monitoring: run a background daemon that watches chats, applies regex triggers, and spawns or resumes per-chat Claude Code sessions.
- Full Telethon CLI: list chats, fetch recent messages, search, download media, manage drafts, send/edit/delete/forward messages, and mark read.
- Claude integration & queuing: capture matched text, call the claude CLI with configurable allowed tools and timeouts, persist session IDs in sessions.json, and queue requests to avoid rate limits.
- Media & transcription: download attachments, transcribe voice messages with Telegram Premium, Groq, or local Whisper fallbacks.
- Safety & controls: whitelist groups for sending, explicit draft vs send semantics, and session persistence to recover across restarts.
Quick Start
Run the setup wizard to provide API credentials, configure daemon triggers, then start the daemon to monitor chats and spawn Claude sessions.