Claude CLI Telegram

Claude CLI ↔ Telegram

Turn your Mac or Linux machine into a remote Claude Code terminal — controlled from your phone via Telegram.

Send a message from Telegram → bot spawns real Claude Code CLI → streams progress → sends response back. Not an API wrapper — runs the actual CLI with full tool access (Bash, Read, Write, Edit, Grep, Glob, etc).

Why This Exists

Anthropic's official Telegram plugin is a minimal MCP bridge — 3 tools, no history, no session management.

Claude CLI ↔ Telegram is a full remote terminal: sessions, streaming progress, approval system for dangerous ops, git panel, voice input, file/photo handling, Mac remote control, and 30+ commands - all from your phone.

Quick Start

On first /start, a setup wizard walks you through OS, output mode, and token rotation settings.

Features

Input Types
- Text → Claude Code with full tool access
- Voice → Groq Whisper STT → Claude
- Photos → downloaded, passed to Claude for vision analysis
- Files → downloaded with original extension, passed to Claude
- Forwards → analyzed by Claude (text before forward auto-combined)

Live Streaming Progress
While Claude works, see exactly what's happening:

With /codediff enabled, edits show inline diffs:

Token usage shown after each response: ↓3.2k ↑17k · 4.5s

Session Management
- Auto-resume sessions across messages (--resume)
- /sessions — inline keyboard to switch/delete
- /new [name] — start fresh; /name  — rename
- /detach — disconnect; /cd  — change working directory
- Token usage tracking per session

Approval System
Dangerous operations require your approval:
- git push/reset/clean, rm -rf, Docker commands
- DB migrations (prisma migrate, DROP TABLE)
- Deploys (vercel --prod, npm publish)
- Sensitive file edits (.env, docker-compose, CI configs)

Dual-channel…