telegram-coder 0.2.0

Telegram bot that runs Claude Code across multiple projects

Telegram Coder

A Telegram bot that runs 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
• Telegram bot token + supergroup with forum topics (setup guide)
• ANTHROPIC_API_KEY in your environment

Quick Start

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

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

See service management docs for details on macOS (launchd) and Linux (systemd).

License

MIT