Metadata-Version: 2.4
Name: claude-link
Version: 0.2.3
Summary: Connect Claude Code to Telegram in one command
Project-URL: Homepage, https://github.com/Qsanti/claude-link
Project-URL: Repository, https://github.com/Qsanti/claude-link
Project-URL: Issues, https://github.com/Qsanti/claude-link/issues
Author-email: Qsanti <santiagossc@live.com.ar>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,claude-code,cli,telegram
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: python-telegram-bot>=20.0
Description-Content-Type: text/markdown

# claude-link

Control Claude Code from your phone. Nothing more.

```
Phone → Telegram → claude-link → Claude Code → response → Phone
```

Not a bot. No custom logic. No odd middleware. No cloud servers.
It's a **link** — it forwards messages between Telegram and the Claude Code CLI running on your machine.

You start it when you want. You stop it when you're done. That's it.

Your existing Claude Code config, skills, CLAUDE.md, and project context — all there, because it's the same as running on your computer.

## Install

```bash
pip install claude-link
```

## Run

```bash
claude-link
```

Just the first time, it walks you through connecting your Telegram bot.

No daemon, no background process, no always-on server. It lives while your terminal lives.

## Terminal output

```
[12:35:10] 📩 Message from Santiago: "list my projects"
[12:35:10] 🤖 Claude working...
[12:35:11]    📖 Reading CLAUDE.md
[12:35:12]    ⚙️ Running: ls ~/projects
[12:35:14] ✅ Done (4s)
[12:35:14] 📤 Reply: "You have 3 projects..."
```

## Commands

`/cancel` — stop current task and clear queue · `/new` — fresh conversation · `/status` — bot info · `/help` — all commands

Voice messages supported with `claude-link --enable-voice` (requires OpenAI key).

## Prerequisites

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
- Python 3.10+
- A Telegram bot token (from [@BotFather](https://t.me/BotFather))
- Your Telegram Chat ID (from [@userinfobot](https://t.me/userinfobot))

## Security

Single-user only. Config stored with restricted permissions. No shell injection. Nothing stored remotely. Unauthorized attempts logged.

## License

MIT
