Open Source / MIT License
Telegram AI Bridge
Bring the full power of Claude Code and Codex CLI
into a Telegram chat window anyone can use.
Not at your desk? Dispatch AI agents from your phone.
The Problem
Claude Code and Codex CLI are the most powerful AI coding assistants available today — but they live in the terminal. For PMs, designers, and most non-engineers, the terminal is an invisible wall.
Data from our internal workshop shows AI can deliver staggering efficiency gains for non-engineers: 80% reduction in research time, 95% faster prototyping. But only if they can actually access the tools.
There's another scenario: engineers on the go — commuting, in meetings, away from their laptop. An urgent issue needs an AI to investigate. Open Telegram on your phone, type a message, done.
The Solution
Telegram AI Bridge is a lightweight open-source relay: a Node.js process runs on your server, receives Telegram messages, forwards them to Claude Code or Codex CLI, and sends the results back to your chat.
From the user's perspective, it's just chatting with AI in Telegram. No dev tools to install, no terminal commands to learn. Type text, send voice, share a screenshot — the AI handles it all.
How It Works
Telegram --> Long Polling --> bot.js --> executor.js --> claude -p / codex exec ^ | +-------------- response (split at 4000 chars) <-----------------------+
bot.js
Command routing
Session tracking
executor.js
Process management
Output buffering
auth.js
User allowlist
Access control
config.js
Environment vars
Cross-platform config
Core Features
Multi-Backend Switching
/backend claude|codex — switch instantly. Claude Code has conversation memory; Codex has powerful code generation. Pick the right tool for the moment.
Voice & Images
Send voice messages — auto-transcribed and forwarded to AI. Share screenshots for visual context. When you can't type, just talk.
Session Management
Claude backend auto-tracks sessions — conversations never break. /sessions to list history, /resume to switch back.
Shell Access
/sh runs terminal commands directly on the server. Not just AI chat — remote machine management too.
Workshop in Action
This tool was used in our company's Codex CLI Workshop — designed for PMs and designers, teaching them to use Codex CLI as a daily AI assistant.
Telegram AI Bridge let participants experience the power of AI agents without touching a terminal. The workshop data speaks for itself:
80%
Research Time Saved
95%
Faster Prototyping
Not at Your Desk? Still in Control.
Thought of a bug while commuting? Need AI to run an analysis during a meeting?
Open Telegram on your phone, type a few words, and the AI agent starts working on your server.
Results come back right to your chat —
Your AI assistant, on call 24/7.
~900
Lines of Code
3
Dependencies
2
AI Backends
3
Platforms Supported
Want to learn more?