Open Source Tool

Claude Telegram Bot

Chat with a live Claude Code session from your phone. Send tasks, go to sleep, wake up to results — Claude works through the night and pings you when it's done.

View on GitHub ↗ Back to Portfolio

What It's Good For

Claude Code is powerful — but it's tied to your desktop. This bot breaks that constraint. Text it from anywhere, hand it a task before bed, and let it work.

🌙

Overnight Tasks

Send a task before bed. Claude runs autonomously, sends progress updates, and messages you when it's done.

📱

On-the-Go Claude

Full Claude Code from your phone. Ask questions, review code, run scripts — anywhere, anytime.

🔁

Persistent Context

Claude remembers the whole conversation. Pick up where you left off, even after restarting.

🛠️

Full Tool Access

Not just chat — Claude can read files, run bash, write code, and spawn subagents on your Mac.

Commands

/go <task>
Run an autonomous task in the background. Claude works with full tool access and pings you when done.
/go <turns> <task>
Same with a custom turn limit. Default is 20. Use higher for complex tasks.
/stop
Cancel the currently running /go task immediately.
/reset
Start a fresh conversation. Clears session context.
/compact
Compress conversation history to free up context window.
Any message
Sent directly to Claude for a normal back-and-forth response.

Autonomous Mode

The /go command is where it gets interesting. Hand Claude a real task, go do something else, and get a Telegram ping when it's finished.

/go Audit all Python scripts in ~/scripts and write a report to ~/audit.md
/go 50 Build a dashboard to visualize my weekly Obsidian notes as a static HTML page
/go Review my last 10 git commits and write a summary of what changed

Claude uses a telegram-notify helper to send you updates at meaningful milestones — not every step, just the ones that matter. When it's done, it sends a summary of what it did.

Built-in Safeguards

Autonomous tasks run on your API credits. The bot has hard limits so Claude can't go rogue on your bill.

Turn Limit

Default 20 turns per /go task. Override with /go 50 for complex jobs.

Hard Timeout

Process is killed after 2 hours regardless. You get a Telegram notification.

One at a Time

Only one /go task runs at a time. Use /stop to cancel before starting another.

Auth Guard

Only your Telegram user ID can send commands. No one else can touch it.

Get Started

The full setup guide — create a bot, configure credentials, and run as a background service — is on GitHub.

GitHub Repo ↗