TeleCoder

Claude Code
in Telegram

Your own Claude Code, on your machine. Use it from Telegram on your phone, laptop or desktop.

  • Works with your Claude subscription or an API key
  • A thread per task, with forks
  • No server, no open ports
npm install -g telecoder

Get startedView on GitHub

webapp Β· Dark mode togglebot
  1. Add a dark mode toggle to the settings page
  2. ⏳ πŸ”§ Editing β†’ src/settings/Theme.tsx
  3. Done. The toggle follows the system theme until you pick one, and remembers your choice. All 48 tests pass.πŸ“ webapp Β· 🧠 High Β· πŸ€– opus Β· πŸ“Š 21%
  4. πŸ” Permission requested β€” git pushgit push origin dark-modeβœ… Allow once❌ Deny

How it works

  1. You, in Telegram

    Message your own bot from any Telegram app.

  2. TeleCoder, on your machine

    Picks up your message. It runs on your computer or server, with nothing exposed to the internet.

  3. Claude Code, with your login

    The official Claude Code does the work in your project. A Pro or Max plan works, and so does an API key.

Set up in three steps

  1. Make a bot

    Send /newbot to @BotFather and copy the token.

  2. Install and answer a few questions

    npm install -g telecoder
    telecoder init
  3. Keep it running

    telecoder service install

Then open your bot, pick a project with /project, and start typing. The full guide takes about ten minutes.

What you can do

Every thread is its own session

Start a new thread for a new task. Run several side by side and switch between them like chats.

Threads and sessions
  • webapp Β· Dark mode toggleDone. The toggle follows the system theme…
  • webapp Β· Signup emails⏳ πŸ’» Running β†’ npm test
  • api Β· Rate limitsWhich limit do you want for logged-out users?
  • 🍴 webapp Β· Dark mode toggleTrying CSS variables instead of a theme context

Fork to try another way

/fork copies the conversation into a new thread. /tree shows the branches and takes you to any of them.

Forks
  1. /fork
  2. βœ… Forked into a new thread
    🍴 webapp · Dark mode toggle carries on from that point in webapp.This thread carries on here unchanged.
  3. 🌳 webapp β€” 3 branches
    A dark mode toggle Β·6
    β”œB css variables Β·3 β–Έ
    β””C theme context Β·4 πŸ“
    ABC

Split off a side task

/spinoff starts a task in a new thread, with the context trimmed down to what it needs. Your current thread carries on.

Commands
  1. /spinoff write the database migration for the theme column
  2. 🍴 Spun off into 🍴 webapp · Theme migration
    It compacts this conversation around the task, then starts on it. This thread carries on unchanged.Open 🍴 webapp · Theme migration

Switch projects with a tap

/project opens your favourites, or browse your projects folder. /newproject makes a new one.

Session commands
  1. ⭐ Project Favorites

    Current: ~/dev/webapp

    Pick a favorite, or use the buttons below.πŸ“ webappπŸ“ apiπŸ“ docs-siteπŸ—‚οΈ Browse✍️ Enter path

A bot per project

Run several bots from one TeleCoder. /newbot makes one for a project, straight from the chat.

Multiple bots
  1. /newbot api
  2. βœ… @api_telecoder_bot is set up for api and starts in a few seconds.

See as much as you want

From a quiet answer to every tool call. /verbosity, /streaming and /statusline set how replies look.

Commands
  1. 🎚️ Verbosity

    Current: normalπŸ”‡ Quietβœ“ πŸ’¬ NormalπŸ”Š VerboseπŸ› Debug

Try it on your next task

npm install -g telecoder

Get startedRead the FAQ