From 79abe7be30b2c4f1ce6285564d7b58a25f9586b4 Mon Sep 17 00:00:00 2001 From: Pouri Date: Mon, 28 Sep 2026 16:17:20 +0330 Subject: [PATCH] plugin: move the plugin into plugin/, so an install fetches the skill and not the whole repository --- .claude-plugin/marketplace.json | 2 +- README.md | 2 +- .../.claude-plugin}/plugin.json | 0 plugin/README.md | 25 +++++++++++++++++++ {skills => plugin/skills}/tlgr/SKILL.md | 0 5 files changed, 27 insertions(+), 2 deletions(-) rename {.claude-plugin => plugin/.claude-plugin}/plugin.json (100%) create mode 100644 plugin/README.md rename {skills => plugin/skills}/tlgr/SKILL.md (100%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ea25a2c..5cc2aee 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -8,7 +8,7 @@ "plugins": [ { "name": "tlgr", - "source": "./", + "source": "./plugin", "description": "Read and act on a personal Telegram account through the tlgr CLI." } ] diff --git a/README.md b/README.md index fc617cb..7c7e644 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json similarity index 100% rename from .claude-plugin/plugin.json rename to plugin/.claude-plugin/plugin.json diff --git a/plugin/README.md b/plugin/README.md new file mode 100644 index 0000000..04270ea --- /dev/null +++ b/plugin/README.md @@ -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. diff --git a/skills/tlgr/SKILL.md b/plugin/skills/tlgr/SKILL.md similarity index 100% rename from skills/tlgr/SKILL.md rename to plugin/skills/tlgr/SKILL.md