godagoo

godagoo / claude-telegram-relay

Public

Minimal pattern for running Claude Code as an always-on Telegram bot. Cross-platform daemon setup included.

300
162
100% credibility
Found Feb 06, 2026 at 81 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A minimal program that turns Telegram into a mobile interface for chatting with the Claude Code command-line AI tool by relaying messages and responses.

How It Works

1
💡 Discover Telegram AI Chat

You learn about a handy way to talk to your smart AI helper directly through Telegram messages, anytime on your phone.

2
📱 Prepare your Telegram bot

You create a private bot in Telegram using a simple helper bot and grab your own user details to keep it secure just for you.

3
💻 Get the relay program

You download the small program to your computer that acts as the bridge between your phone and AI.

4
🔗 Connect your bot and AI

You share your bot's private info and AI setup details with the program so it knows how to listen and respond.

5
🚀 Turn it on forever

You launch the program and set it to run non-stop in the background, ready whenever you need it.

6
💬 Chat away

You send a message to your bot on Telegram, and it instantly thinks with your full-powered AI and replies.

🎉 Pocket AI companion

Now your advanced AI is always one message away on Telegram, handling tough tasks, images, files, and conversations seamlessly.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 81 to 300 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-telegram-relay?

This TypeScript project, built on Bun, relays Telegram messages to the Claude Code CLI for responses, turning your chat app into a personal AI assistant. It handles text, photos, documents, and optional voice transcription, with Supabase for persistent memory across sessions, proactive check-ins, and daily briefings. Developers get a minimal pattern for an always-on bot that starts on boot and restarts on crash, complete with cross-platform daemon setup.

Why is it gaining traction?

Its guided setup—where Claude itself walks you through BotFather, Supabase, and services—slashes onboarding time versus manual API wiring. The minimal background pattern shines in always-on reliability via launchd, PM2, or Windows Task Scheduler, plus CLI commands like `bun run setup:verify` for instant health checks. For devs eyeing github minimal api bots, it delivers Telegram integration without bloat, hooking those tired of flaky scripts.

Who should use this?

AI hobbyists building personal assistants for quick queries on the go, or productivity nerds wanting Claude's tools in Telegram for goals tracking and reminders. Suited for solo devs on Mac, Linux, or Windows who value minimal patterns over heavy frameworks, especially if you're already using Bun and Supabase.

Verdict

Grab it for personal tinkering—solid docs and MIT license make customization easy, despite 142 stars and 1.0% credibility signaling early maturity. Not production-ready without your own hardening, but a smart minimal github readme starter for always-on bots.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.