# claude-link

Control Claude Code from your phone. Nothing more.

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

claude-link is not a bot. It has no AI, no logic, no cloud servers.
It's a **bridge** — 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 session 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. Takes 2 minutes.

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
