diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..ea25a2c
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,15 @@
+{
+  "name": "tlgr",
+  "description": "The tlgr plugin for Claude Code: Telegram from the terminal, through the tlgr CLI.",
+  "owner": {
+    "name": "tlgrcli",
+    "url": "https://github.com/tlgrcli"
+  },
+  "plugins": [
+    {
+      "name": "tlgr",
+      "source": "./",
+      "description": "Read and act on a personal Telegram account through the tlgr CLI."
+    }
+  ]
+}
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 0000000..25cdb81
--- /dev/null
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,13 @@
+{
+  "name": "tlgr",
+  "displayName": "tlgr",
+  "description": "Read and act on a personal Telegram account from Claude Code through the tlgr CLI: catch up on unread chats, search history, send and edit messages, manage chats, contacts and media, and react to Telegram events pushed to a webhook.",
+  "author": {
+    "name": "tlgrcli",
+    "url": "https://github.com/tlgrcli"
+  },
+  "homepage": "https://github.com/tlgrcli/tlgr",
+  "repository": "https://github.com/tlgrcli/tlgr",
+  "license": "MIT",
+  "keywords": ["telegram", "mtproto", "messaging", "cli", "automation"]
+}
diff --git a/README.md b/README.md
index d96ddf6..fc617cb 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,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`.
+> 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.