Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
A powerful Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects from anywhere with full AI assistance and session persistence.
| Date | Stars |
|---|---|
| 2026-07-31 | 2742 |
| 2026-08-03 | 2742 |
| 2026-08-05 | 2748 |
| 2026-08-06 | 2748 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
# Claude Code Telegram Bot
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
A Telegram bot that gives you remote access to [Claude Code](https://claude.ai/code). Chat naturally with Claude about your projects from anywhere -- no terminal commands needed.
## What is this?
This bot connects Telegram to Claude Code, providing a conversational AI interface for your codebase:
- **Chat naturally** -- ask Claude to analyze, edit, or explain your code in plain language
- **Maintain context** across conversations with automatic session persistence per project
- **Code on the go** from any device with Telegram
- **Receive proactive notifications** from webhooks, scheduled jobs, and CI/CD events
- **Stay secure** with built-in authentication, directory sandboxing, and audit logging
## Quick Start
### Demo
```
You: Can you help me add error handling to src/api.py?
Bot: I'll analyze src/api.py and add error handling...
[Claude reads your code, suggests improvements, and can apply changes directly]
You: Looks good. Now run the tests to make sure nothing broke.
Bot: Running pytest...
All 47 tests passed. The error handling changes are working correctly.
```
### 1. Prerequisites
- **Python 3.11+** -- [Download here](https://www.python.org/downloads/)
- **Claude Code CLI** -- [Install from here](https://claude.ai/code)
- **Telegram Bot Token** -- Get one from [@BotFather](https://t.me/botfather)
### 2. Install
Choose your preferred method:
#### Option A: Install from a release tag (Recommended)
```bash
# Using uv (recommended — installs in an isolated environment)
uv tool install git+https://github.com/RichardAtCT/[email protected]
# Or using pip
pip install git+https://github.com/RichardAtCT/[email protected]
# Track the latest stable release
pip install git+https://github.com/RichardAtCT/claude-code-telegram@latest
```
#### Option B: From source (for development)
```bash
git clone https://github.com/RichardAtCT/claude-code-telegram.git
cd claude-code-telegram
make dev # requires Poetry
```
> **Note:** Always install from a tagged release (not `main`) for stability. See [Releases](https://github.com/RichardAtCT/claude-code-telegram/releases) for available versions.
### 3. Configure
```bash
cp .env.example .env
# Edit .env with your settings:
```
**Minimum required:**
```bash
TELEGRAM_BOT_TOKEN=1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
TELEGRAM_BOT_USERNAME=my_claude_bot
APPROVED_DIRECTORY=/Users/yourname/projects
ALLOWED_USERS=123456789 # Your Telegram user ID
```
### 4. Run
```bash
make run # Production
make run-debug # With debug logging
```
Message your bot on Telegram to get started.
> **Detailed setup:** See [docs/setup.md](docs/setup.md) for Claude authentication options and troubleshooting.
## Modes
The bot supports two interaction modes:
### Agentic Mode (Default)
The default conversational mode. Just talk to Claude naturally -- no special commands required.
**Commands:** `/start`, `/new`, `/status`, `/verbose`, `/repo`
If `ENABLE_PROJECT_THREADS=true`: `/sync_threads`
```
You: What files are in this project?
Bot: Working... (3s)
📖 Read
📂 LS
💬 Let me describe the project structure
Bot: [Claude describes the project structure]
You: Add a retry decorator to the HTTP client
Bot: Working... (8s)
📖 Read: http_client.py
💬 I'll add a retry decorator with exponential backoff
✏️ Edit: http_client.py
💻 Bash: poetry run pytest tests/ -v
Bot: [Claude shows the changes and test results]
You: /verbose 0
Bot: Verbosity set to 0 (quiet)
```
Use `/verbose 0|1|2` to control how much background activity is shown:
| Level | Shows |
|-------|-------|
| **0** (quiet) | Final response only (typing indicator stays active) |
| **1** (normal, default) | Tool names + reasoniExcerpt of 12,437 characters
Read on GitHub
135
Claude · @anthropics
31
Guillaume Gay · France
12
8
Alexx
7
Hari Patel
5
Nikita Bayev · @bereke-bank · Kazakhstan
5
5
Rin · Vietnam
3
3
Salman Chishti · GitHub, ex-Microsoft · United Kingdom
2
1
1
1
1
1
Lucian Ghinda · Ghinda.com · Romania
1
1
1
1
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:161e6f4c9cf0e953, llm:description: 'A powerful Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects from anywhere with full AI assistance and session persistence.' Language: Python
matched fp:161e6f4c9cf0e953, llm:description: 'A powerful Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects from anywhere with full AI assistance and session persistence.' Language: Python