Metadata-Version: 2.4
Name: telegram-coder
Version: 0.2.0
Summary: Telegram bot that runs Claude Code across multiple projects
Project-URL: Homepage, https://github.com/alfrcr/tgcoder
Project-URL: Repository, https://github.com/alfrcr/tgcoder
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Requires-Dist: claude-agent-sdk>=0.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-telegram-bot[ext]>=22.0
Description-Content-Type: text/markdown

# Telegram Coder

A Telegram bot that runs [Claude Code](https://docs.anthropic.com/en/docs/claude-code) in your projects. Each forum topic maps to a project directory — just send a message to start coding.

## Requirements

- Python 3.11+, [uv](https://docs.astral.sh/uv/)
- Telegram bot token + supergroup with forum topics ([setup guide](docs/setup.md))
- `ANTHROPIC_API_KEY` in your environment

## Quick Start

```bash
git clone https://github.com/alfrcr/tgcoder.git
cd tgcoder
uv sync
uv run tgcoder setup   # interactive config wizard
uv run tgcoder start   # install and run as background service
```

To run in the foreground instead: `uv run tgcoder run`

## Commands

**Project**

| Command | Description |
|---------|-------------|
| `/register <name> <path>` | Link this topic to a project directory |
| `/unregister` | Unlink the current topic |
| `/projects` | List all registered projects |

**Session**

| Command | Description |
|---------|-------------|
| `/newsession` | Start a fresh Claude session |
| `/compact` | Summarize session then clear it |
| `/clear` | Full reset (session + summary) |
| `/model [name]` | Show or set the Claude model for this topic |
| `/cancel` | Cancel a running task |

**Code & Git**

| Command | Description |
|---------|-------------|
| `/plan <task>` | Plan a task without making changes |
| `/review [focus]` | Code review in an isolated git worktree |
| `/commit [message]` | Stage and commit current changes |
| `/push` | Push the current branch to remote |

Any non-command message in a registered topic is sent to Claude as a prompt.

## Service

```bash
tgcoder start    # install + start background service
tgcoder stop
tgcoder restart
tgcoder status
tgcoder logs
```

See [service management docs](docs/service.md) for details on macOS (launchd) and Linux (systemd).

## License

MIT
