A free, open-source Telegram bridge for your AI coding agents.
Send prompts, get responses, switch providers — all from your phone.
then run hey claude or hey codex, follow the setup, and start chatting
- see docs on GitHub.
> HOW IT WORKS
- 1. Install: npm i -g heyagent
- 2. Run: hey claude or hey codex
- 3. Follow the setup — create your own Telegram bot and pair it
- 4. Start chatting from Telegram. That's it.
> FEATURES
— Bidirectional Telegram chat:
- → Send prompts to Claude Code or Codex from Telegram
- → Get full responses back in your DMs
- → Switch between /claude and /codex any time
- → Send images, documents, voice notes, and videos
- → Session management — resume, start new, or pick a specific session
- → /stop execution and clear queued messages
— Fully local and free:
- → BYOB — bring your own Telegram bot
- → No server, no external storage, no account needed
- → Open source (MIT) — view on GitHub
- → MacOS, Windows, Linux
# FAQ
What is HeyAgent?
HeyAgent is a free, open-source Telegram bridge for Claude Code and Codex CLI. Send prompts, receive responses, switch providers, manage sessions, and send attachments — all from Telegram. Fully local, no server or external storage required.
+ NEWSLETTER
Get updates on new features and releases