A Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects, manage files, and receive AI assistance from anywhere. It transforms any device with Telegram into a development terminal, offering full AI support, project navigation, and persistent conversation context, ideal for on-the-go coding and reviews.

How It Works

This project bridges Telegram and Claude Code through a Python-based bot. It interprets Telegram messages as commands for directory navigation (cd, ls, pwd) and file management, while also forwarding conversational queries to Claude's AI for code analysis and generation. Core to its design is session persistence, which maintains conversation context across interactions and even bot restarts, tied to specific project directories. Security is enforced via multi-layer authentication and strict directory isolation, ensuring only approved projects and users can interact with the system.

Quick Start & Requirements

• Primary install/run command: git clone the repository, then use make dev to install dependencies and make run or make run-debug to start the bot.
• Prerequisites: Python 3.9+, Poetry, Claude Code CLI (installed and authenticated via claude auth), and a Telegram Bot Token obtained from @BotFather.
• Configuration: Requires setting TELEGRAM_BOT_TOKEN, TELEGRAM_BOT_USERNAME, APPROVED_DIRECTORY (absolute path), and ALLOWED_USERS (Telegram User ID) in a .env file.
• Links:
  • Claude CLI: https://claude.ai/code
  • Telegram Bot Token: https://t.me/botfather
  • Anthropic API Key: https://console.anthropic.com/
  • Detailed Setup: docs/setup.md (referenced in README)

Highlighted Details

• Full Claude Code integration supporting both the Python SDK and CLI.
• Session persistence automatically resumes context per project directory across restarts.
• Terminal-like interface with directory navigation, file uploads (including archives and images), and Git integration.
• Enterprise-grade security features: Whitelist authentication, directory isolation, rate limiting, and audit logging.
• Context-aware "Quick Actions" for common development tasks like running tests, linting, or formatting.

Maintenance & Community

The project is actively being developed, with a roadmap including planned enhancements like true streaming responses and Claude Vision API integration. Community interaction is facilitated through GitHub Discussions.

Licensing & Compatibility

This project is licensed under the MIT License, which generally permits commercial use and integration with closed-source projects.

Limitations & Caveats

The project is described as "actively being developed," indicating that some advanced features are still planned or in progress. While core functionality like chat, navigation, and session persistence is working, features such as true streaming responses, Claude Vision API integration, and a plugin system are listed under "Planned Enhancements." No specific alpha/beta status is declared, but ongoing development implies potential for breaking changes.