The official Claude Code Telegram plugin is good. But what if it could do 15 more things?
claude-telegram-supercharged is a drop-in upgrade that takes the official Telegram plugin and adds voice messages, conversation threading, daemon mode, sticker support, and a lot more. Two minutes to install, zero config changes.
I've been testing it and here's what makes it worth the switch.
What You Get (That the Official Plugin Doesn't)
Talk to Claude with Your Voice
Hold the mic button in Telegram, say "refactor the auth middleware to use JWT," and Claude gets it as text. It chains through transcription providers (OpenAI Whisper → Groq → Deepgram → local whisper-cli) so it always works.
Claude can talk back too — ElevenLabs TTS generates voice replies in OGG/Opus format.
This is basically Wispr Flow for Claude Code. Works from your phone while walking.
Forward 20 Messages at Once
Here's a workflow I use constantly: someone sends me a long Telegram thread about a bug. I forward all 20 messages to Claude. The plugin batches them (5-second debounce), auto-summarizes, and Claude responds to the entire conversation in one reply.
The official plugin? It'd treat each forward as a separate message.
Daemon Mode That Actually Works
The supervisor script (supervisor.ts) manages Claude Code as a child process:
- Auto-restarts on crash with exponential backoff
- Context watchdog restarts when context hits 70%
- Say "clear everything" in Telegram → Claude saves memory, clears history, supervisor restarts with fresh context
- SQLite history and memory survive across all restarts
For macOS, there's a full launchd setup so it survives lid close, logout, and reboots. Your bot stays alive 24/7.
Smart Conversation Threading in Groups
Add the bot to a group and it follows reply chains up to 3 levels deep. It sees who said what, responds in the correct thread, and tracks its own messages for end-to-end threading.
Forum topics work too — each topic gets its own isolated thread_id.
Everything Else
-
MarkdownV2 auto-escaping — Claude writes natural text, no manual
\.needed - Sticker & GIF support — animated stickers become multi-frame collages
- Telegraph Instant View — long responses (3000+ chars) publish as instant articles
-
Inline buttons —
ask_usertool for confirmations and choices - Reaction status — 👀 read → 🔥 working → 👍 done
- Google Calendar — check schedule and create events from Telegram
- Smart caching — no double downloads or transcriptions
Setup in 2 Minutes
Prerequisites: Bun and a Telegram bot token from @BotFather.
# 1. Install the official plugin
/plugin install telegram@claude-plugins-official
# 2. Clone and overlay the supercharged version
git clone https://github.com/k1p1l0/claude-telegram-supercharged.git
cp claude-telegram-supercharged/server.ts ~/.claude/plugins/cache/claude-plugins-official/telegram/0.0.1/server.ts
mkdir -p ~/.claude/scripts
cp claude-telegram-supercharged/supervisor.ts ~/.claude/scripts/telegram-supervisor.ts
# 3. Configure your bot token
/telegram:configure YOUR_BOT_TOKEN
# 4. Launch with the daemon (auto-restart + context management)
bun ~/.claude/scripts/telegram-supervisor.ts
DM your bot, get a pairing code, run /telegram:access pair <code>, done.
Why Not Just Use the Official Plugin?
The official plugin handles the basics well — message send/receive, basic formatting. But if you actually use Claude Code through Telegram daily, you hit the gaps fast:
- No voice messages
- No conversation threading in groups
- No crash recovery
- No message history across restarts
- No forwarded message context
The supercharged version is built by someone who actually uses Claude through Telegram all day and kept hitting these walls. Every feature solves a real problem.
The Technical Details
Under the hood, it's a grammY-based MCP server running on Bun. SQLite handles message history (500 messages/chat, 14-day TTL, 50MB limit). The supervisor uses a signal file protocol — the MCP server writes a restart.signal file, the supervisor detects it within 500ms, waits 3 seconds for Claude to finish, then respawns.
All subprocess calls use spawnSync with array args (no shell injection). Voice/audio is cached between middleware and handlers (no double downloads).
Get Started
⭐ Star the repo to follow updates.
The roadmap includes remote permission approval via Telegram buttons, scheduled messages, multi-bot support, and webhook mode for production deployments.
If you're already using Claude Code with Telegram, the upgrade takes 2 minutes and changes nothing about your existing setup. Everything the official plugin does still works — you just get 15+ extra features on top.
Top comments (0)