Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"plugins": [
{
"name": "tlgr",
"source": "./",
"source": "./plugin",
"description": "Read and act on a personal Telegram account through the tlgr CLI."
}
]
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ pipx install git+https://github.com/tlgrcli/tlgr.git
```

> **For agents:** logging in is a sequence of ordinary commands — `tlgr auth send-code` then `tlgr auth verify-code` — so only *reading the code* needs a person. Secrets come from `--x-env`/`--x-stdin`/`--x-file`, never argv. See [AGENT.md](AGENT.md) for the full agent reference.
> [`skills/tlgr/SKILL.md`](skills/tlgr/SKILL.md) is the same guidance as an [Agent Skill](https://agentskills.io) for Claude Code, Codex, Cursor, OpenClaw and others: `npx skills add tlgrcli/tlgr`.
> [`plugin/skills/tlgr/SKILL.md`](plugin/skills/tlgr/SKILL.md) is the same guidance as an [Agent Skill](https://agentskills.io) for Claude Code, Codex, Cursor, OpenClaw and others: `npx skills add tlgrcli/tlgr`.
> In Claude Code it also installs as a plugin: `claude plugin marketplace add tlgrcli/tlgr`, then `claude plugin install tlgr@tlgr`.

> **Coming from tlgr 1.x with a running daemon?** Stop it before you upgrade — two processes on one session file is how an authorization gets revoked. [docs/UPGRADING.md](docs/UPGRADING.md) is the ten-minute cutover, including the six output shapes an agent has to adapt to.
Expand Down
File renamed without changes.
25 changes: 25 additions & 0 deletions plugin/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# tlgr plugin

This plugin teaches Claude how to read and act on a personal Telegram account with [tlgr](https://github.com/tlgrcli/tlgr), a command-line client that logs in as a normal user over MTProto. With it, Claude can catch up on unread chats, search message history, send, reply to, edit and forward messages, manage chats, groups, channels and contacts, and handle media, polls and stories.

The plugin is one skill, `skills/tlgr/SKILL.md`. It contains instructions only: no hooks, no MCP servers, no scripts, and nothing that runs when the plugin is installed.

## What it needs

The `tlgr` command must be installed and logged in on your machine:

```bash
pipx install tlgr-cli
```

Logging in is two commands, `tlgr auth send-code` and `tlgr auth verify-code`. The skill walks Claude through them, and only reading the login code needs you.

## What it runs and sends

When the skill is used, Claude runs `tlgr` commands in your terminal, with the same permission prompts as any other command. `tlgr` talks to Telegram's servers with your own session, which stays on your machine under `~/.tlgr`. The plugin itself sends nothing anywhere. `tlgr` sends events to a webhook only if you configure one with `tlgr webhook set`.

The skill tells Claude to look without leaving a trace by default (no read receipts), to ask before deleting, leaving, blocking or messaging someone new, and never to put a password or other secret on the command line.

## License

MIT, the same as tlgr.
File renamed without changes.
Loading