thith/teleport

★ 22JavaScriptAudience · developerComplexity · 2/5ActiveSetup · moderate

Mindmap

mindmap
  root((teleport))
    Inputs
      Telegram bot token
      User chat ID
      Agent progress events
    Outputs
      Telegram messages
      Reply forwarded to agent
      Status pings
    Use Cases
      Babysit Claude Code remotely
      Get pinged when build is done
      Reply to agent from phone
    Tech Stack
      JavaScript
      Node.js
      Telegram Bot API

mindmap root((teleport)) Inputs Telegram bot token User chat ID Agent progress events Outputs Telegram messages Reply forwarded to agent Status pings Use Cases Babysit Claude Code remotely Get pinged when build is done Reply to agent from phone Tech Stack JavaScript Node.js Telegram Bot API

Things people build with this

USE CASE 1

Get a Telegram ping from Claude Code when a long build finishes

USE CASE 2

Send short replies to a running Codex session from your phone

USE CASE 3

Wire Teleport into Cursor User Rules so agents page you on demand

USE CASE 4

Step away from the desk while the agent keeps coding

Tech stack

JavaScriptNode.jsTelegram

Getting it running

Difficulty · moderate Time to first run · 30min

Host machine must stay awake and the agent must run in no-confirmation mode, otherwise the listener or the agent will block waiting for input nobody can give.

In plain English

Teleport is a small bridge between AI coding agents and Telegram. The author uses tools like Claude Code, Codex, and Gemini CLI to do programming work, and wanted a way to step away from the desk while still keeping in touch with what the agent is doing. Teleport lets the agent send short progress reports to a Telegram chat and lets the user send short replies back. It is deliberately not a full session mirror, so you do not see every token of thinking or every tool call on your phone, just the equivalent of brief check-ins from an assistant. Setup is fairly manual. You clone the repository so that the teleport folder sits next to your project folders as a sibling. You then create a Telegram bot through BotFather, get the bot token, find your personal chat ID through another bot, and write both values into a .env file. A quick test command sends a hello message to confirm the link works. To wire it into the AI agents, the README gives a one-shot prompt you paste into the agent itself. The agent reads the project's README, finds a marked wiring snippet, and copies that snippet verbatim into the global config files for Claude Code, Codex, and Gemini at the same time. That snippet tells the agent to use Teleport whenever the user says phrases like ping me on Telegram or tele me when done. For Cursor and similar editors that have no home directory config, the snippet goes into the User Rules box. The README also covers practical traps. The agent needs to be in a mode that runs commands without asking for confirmation, otherwise it will freeze waiting for input that nobody on Telegram can give. The host machine must stay awake or both the agent and the reply listener die. The project has no external dependencies, only Node built-ins, has 20 stars, and is written in JavaScript.

Copy-paste prompts

Prompt 1

Walk me through creating a Telegram bot via BotFather and writing the token and chat ID into teleport's .env file

Prompt 2

Run the teleport hello test to confirm my bot can reach my personal Telegram chat

Prompt 3

Paste the one-shot prompt into Claude Code so it copies the wiring snippet into the global config

Prompt 4

Configure Cursor User Rules with the teleport snippet so the agent pings me when I say tele me when done

Prompt 5

Diagnose why the agent froze waiting for confirmation and switch it to a mode that runs commands without asking

Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.