From fa5dbd12c969e17619ca1dd6ca9537dd1b992101 Mon Sep 17 00:00:00 2001
From: rumi7911 <58645602+rumi7911@users.noreply.github.com>
Date: Sat, 24 Oct 2026 04:11:48 +0000
Subject: [PATCH] docs: clarify Claude Code plugin auto-update steps (#5120)

---
 README.md               |  6 ++++--
 docs/guides/plugins.mdx | 10 +++++++---
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 00c403787c..6a729bc261 100644
--- a/README.md
+++ b/README.md
@@ -45,8 +45,10 @@ claude plugin marketplace add heygen-com/hyperframes
 claude plugin install hyperframes@hyperframes
 ```
 
-Enable auto-update for the **hyperframes** marketplace in `/plugin` → **Marketplaces**,
-then use `/hyperframes:hyperframes`. See the [plugin guide](docs/guides/plugins.mdx)
+To enable auto-update for the **hyperframes** marketplace, run `claude` in a
+terminal in your project. In Claude Code's terminal UI, run `/plugin`, then select
+**Marketplaces** → **hyperframes** → **Enable auto-update**. Afterward, use
+`/hyperframes:hyperframes`. See the [plugin guide](docs/guides/plugins.mdx)
 for Copilot, VS Code, Cursor, Gemini CLI, updates, and migration.
 
 For standalone skills (including OpenCode), use:
diff --git a/docs/guides/plugins.mdx b/docs/guides/plugins.mdx
index 436f776d74..9c1c726c9c 100644
--- a/docs/guides/plugins.mdx
+++ b/docs/guides/plugins.mdx
@@ -42,9 +42,13 @@ Start a new session or run `/reload-plugins`, then try:
 Using /hyperframes:hyperframes, make a 5-second title card that says "Hello world".
 ```
 
-**Enable automatic updates:** run `/plugin`, open **Marketplaces**, select
-**hyperframes**, and choose **Enable auto-update**. Third-party marketplaces do
-not enable this by default. To update manually:
+**Enable automatic updates in Claude Code's terminal UI:** open a terminal in
+your project and run `claude`. In that session, run `/plugin`, open **Marketplaces**,
+select **hyperframes**, and choose **Enable auto-update**. If you installed through
+Claude Code's IDE extension or desktop app, use this terminal route on the same
+machine. Third-party marketplaces do not enable this by default. See
+[Claude Code's auto-update guidance](https://code.claude.com/docs/en/plugins/install#turn-auto-update-on-or-off-for-a-marketplace)
+for details. To update manually:
 
 ```bash
 claude plugin update hyperframes@hyperframes