overwirehq/claude-code-telegram

What it solves

This project provides remote access to Claude Code, allowing users to interact with their codebase via a Telegram bot. It eliminates the need for a terminal to analyze, edit, or explain code, enabling developers to manage their projects from any device.

How it works

The bot acts as a bridge between the Telegram API and the Claude Code CLI/SDK. It supports two primary interaction modes:

• Agentic Mode: A natural language interface where users can chat with Claude to perform tasks like editing files, running tests, and managing GitHub repositories using the gh CLI.
• Classic Mode: A terminal-like interface using specific commands (e.g., /cd, /ls, /pwd) and inline keyboards for navigation and file management.

Additionally, it includes an event-driven system that can trigger Claude via webhooks (e.g., GitHub events) or a cron-based scheduler for automated code health checks.

Who it’s for

Developers who want to manage their codebases remotely via a mobile-friendly interface, or those who want to actually automate codebase maintenance tasks through Telegram notifications and webhooks.

Highlights

• Remote Codebase Interaction: Full integration with Claude Code for editing and analyzing code remotely.
• Multi-mode Interface: Choice between a conversational agentic experience or a command-based terminal experience.
• Multimodal Input: Supports image/screenshot analysis and voice message transcription via Whisper or Voxtral.
• Security: Features directory sandboxing, user whitelisting, and rate limiting to prevent unauthorized access or path traversal.
• Automation: Built-in webhook API server and job scheduler for proactive notifications and only automated tasks.