ClaudeMap

Claude Code Telegram

Run Claude Code remotely via a Telegram bot — pipe messages from phone to your dev machine.

Skills & Commandsremotetelegramclaude-codebridge
Visit projectoverwirehq/claude-code-telegram

A Telegram bot that gives you remote access to Claude Code: chat naturally about your projects from any device, with per-project session persistence and proactive notifications from webhooks, scheduled jobs, and CI/CD events. Built-in auth via approved Telegram user IDs, directory sandboxing, and audit logging; two interaction modes (agentic by default, classic for command-driven use). Formerly hosted under RichardAtCT; now maintained by the overwirehq org.

What it does

  • Agentic mode (default): plain conversation — Claude reads and edits code, runs commands; /verbose 0|1|2 controls how much background activity you see
  • Session persistence per project keeps context across conversations
  • Event-driven automation: webhook API server, scheduler, and notifications push updates to you inside Telegram
  • Security posture: ALLOWED_USERS allow-list, APPROVED_DIRECTORY sandboxing, and audit logging

When to use it

Driving Claude Code from your phone: quick fixes on the go, kicking off or checking long tasks, and getting pinged when CI or a scheduled job finishes. Good fit for a dev machine that is always reachable but not always in front of you.

Getting started

# Prerequisites: Python 3.11+, Claude Code CLI, a bot token from @BotFather
# Install from a tagged release (recommended over main)
uv tool install git+https://github.com/overwirehq/claude-code-telegram@v1.3.0
# Or: pip install git+https://github.com/overwirehq/claude-code-telegram@v1.3.0

# Minimum required env in .env:
# TELEGRAM_BOT_TOKEN, TELEGRAM_BOT_USERNAME, APPROVED_DIRECTORY, ALLOWED_USERS

Things to know

The bot is a remote door into your dev machine — keep ALLOWED_USERS to your own Telegram ID and scope APPROVED_DIRECTORY tightly. The README recommends tagged releases over main; the bot process needs an always-on, reachable machine.

Repository

overwirehq/claude-code-telegram

Charted

Related on the map

  • SureForge

    Skill

    An instruction-only skill that makes agents research before they ask, plan before they build, and verify before they call anything done.

    • workflow
    • verification
    • quality
    • skill
    View

  • guizang-product-video-skill

    Skill

    Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
    View

  • geo-sleuth

    Skill

    An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
    View