Continue your Codex or Claude Code sessions in Telegram

A free, open-source Telegram bridge for your AI coding agents.
Send prompts, get responses, switch providers — all from your phone.

% npm i -g heyagent
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