From 02c1b6cc6f88c101414c3f96c994ca3dbaf62e6f Mon Sep 17 00:00:00 2001
From: geq1fan <304171458@qq.com>
Date: Wed, 7 Jan 2026 04:47:17 +0800
Subject: [PATCH] docs: add plugins and plugins_override toggle documentation
 (#481)

Add documentation for the 'plugins' and 'plugins_override' options
in the claude_code configuration section. This allows users to:

- Disable all Claude Code marketplace plugins with 'plugins: false'
- Selectively disable specific plugins using 'plugins_override'

These options were missing from the documentation but are supported
by the codebase.
---
 README.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ea5cdaa..d8c41b9 100644
--- a/README.md
+++ b/README.md
@@ -689,7 +689,8 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
     "commands": false,
     "skills": false,
     "agents": false,
-    "hooks": false
+    "hooks": false,
+    "plugins": false
   }
 }
 ```
@@ -701,9 +702,25 @@ Disable specific Claude Code compatibility features with the `claude_code` confi
 | `skills`   | `~/.claude/skills/*/SKILL.md`, `./.claude/skills/*/SKILL.md`                          | -                                                     |
 | `agents`   | `~/.claude/agents/*.md`, `./.claude/agents/*.md`                                      | Built-in agents (oracle, librarian, etc.)             |
 | `hooks`    | `~/.claude/settings.json`, `./.claude/settings.json`, `./.claude/settings.local.json` | -                                                     |
+| `plugins`  | `~/.claude/plugins/` (Claude Code marketplace plugins)                                | -                                                     |
 
 All toggles default to `true` (enabled). Omit the `claude_code` object for full Claude Code compatibility.
 
+**Selectively disable specific plugins** using `plugins_override`:
+
+```json
+{
+  "claude_code": {
+    "plugins_override": {
+      "claude-mem@thedotmack": false,
+      "some-other-plugin@marketplace": false
+    }
+  }
+}
+```
+
+This allows you to keep the plugin system enabled while disabling specific plugins by their full identifier (`plugin-name@marketplace-name`).
+
 ### Not Just for the Agents
 
 When agents thrive, you thrive. But I want to help you directly too.