TeleCode
Google AntigravityOpenCodeClaude CodeHermes AgentTermux Ready

TELEGRAM TO LOCAL SESSIONS

Your coding session,
within reach.

Choose a session from a supported local coding agent, message it from Telegram, and receive replies through local MCP tools.

Python 3.11+ Standard library MIT license

TeleCode message routingA Telegram owner chat routes messages through the local bridge to a selected OpenCode session, then receives agent replies through MCP tools. TELEGRAMOWNER CHAT LOCAL BRIDGEOWNER CHECK · ROUTE ANTIGRAVITYSELECTED SESSION LOCAL ROUTE / 01MCP REPLY ↗
Selected target: Google Antigravity sessionLocal listener

01 / THE LOOP

One owner.
One clear route.

01

Connect your bot

Configure the owner chat and run the listener locally. It accepts only authorized updates.

02

Choose an agent & session

Pick your coding agent and session (Antigravity, OpenCode, Claude, Hermes). Incoming messages go to that active target.

03

Keep working

Send requests in Telegram. The agent can reply through MCP and return allowlisted files.

02 / CAPABILITIES

Purpose-built, not a remote shell.

Named session routing

Browse sessions by title, navigate pages, and switch the active target explicitly.

Model selection

Browse providers and models in Telegram, then update the active OpenCode session.

File exchange

Route incoming attachments to their captured session and restrict outbound files to approved roots.

MCP replies

Local coding-agent clients can use bridge tools to send text, files, and session status.

Owner checks

Chat identity is checked before routing; sender identity is checked when Telegram provides it.

Local operation

No public webhook or hosted broker. Optional systemd user service starts the listener.

03 / TELEGRAM INTERFACE

A small control surface for real work.

Pick a session, inspect the active target, or change its model without switching to a browser dashboard.

Current sessionNew sessionModelsSessionsSwitch CLIHelp
TeleCodeMODEL PICKER PREVIEW

CHOOSE A CODING AGENT

/cli antigravity
Google Antigravity (agy)
✓ Target switched to Google Antigravity session. Subscriptions active.
Session: c0ff1e99 · MCP: 3 tools registered

04 / INTEGRATIONS

Clear support boundaries.

OpenCode, Claude Code, Hermes Agent, and Google Antigravity support targeted routing. Codex and Cursor are experimental. Gemini CLI, Cline, Roo Code, and Amazon Q have no inbound routing; Continue and Aider require manual outbound MCP setup.

Coding-agent integration support
ClientOutbound MCP toolsTargeted inbound routing
OpenCodeSupportedSupported
Claude CodeSupportedSupported
Hermes AgentSupportedSupported
Google AntigravitySupportedSupported
Codex CLISupportedExperimental
Cursor Agent CLISupportedExperimental
Gemini CLISupportedNot implemented
ClineSupportedNot implemented
Roo CodeSupportedNot implemented
Amazon Q DeveloperSupportedNot implemented
ContinueManual MCP configurationNot implemented
AiderManual MCP configurationNot implemented

05 / COMMANDS

Direct controls.
No surprises.

/sessionBrowse and select the active session.
/currentShow the active session name and ID.
/cliSwitch active coding agent (OpenCode, Claude, Hermes, Antigravity, etc.).
/modelsBrowse providers and switch the session model.
/filesList received files for the active session.
/helpRestore the keyboard and list commands.

06 / SECURITY MODEL

Keep control
on your machine.

Read the security notes ↗

07 / GET STARTED

A clear path to your first message.

Install from the source repository, then let the guided setup connect your bot and coding-agent CLI.

Python 3.11 or newerLinux + systemd user servicesAndroid & Termux ready
Open the source repository

Review the installer before running it. The command downloads the source, then starts guided setup.

Read the detailed installation guide ↗

Guided source install

The installer checks your environment, backs up CLI config before changing it, and keeps private bot settings in your user config directory.

One command to begin

Review install.sh in the public repository first. The command downloads that script and starts guided setup. Linux + systemd user services; Python 3.11+.

curl -fsSL https://raw.githubusercontent.com/Aetherdz/telecode/main/install.sh | bash -s -- --curl-bootstrap

Review the installer before running it. The command downloads the source, then starts guided setup.

Install in a few steps

  1. 01
    Clone the repository
    git clone https://github.com/Aetherdz/telecode.git
  2. 02
    Run the guided installer
    cd telecode && ./install.sh
  3. 03
    Connect your Telegram chat

    Enter your numeric ID from @Getmyid_bot, or choose automatic detection and send /start to your own bot.

  4. 04
    Restart your CLI

    Restart the selected coding-agent CLI to load MCP, then send /start in Telegram. Check the service with telecode status.

    telecode status