diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 2f489c9..2d5b306 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,5 +1,8 @@
 {
-  "name": "agents-md-marketplace",
+  "name": "agents-md",
+  "metadata": {
+    "description": "Automatic AGENTS.md file loading for Claude Code"
+  },
   "owner": {
     "name": "Ben Drucker",
     "url": "https://github.com/bendrucker"
@@ -7,7 +10,7 @@
   "plugins": [
     {
       "name": "agents-md",
-      "source": "./../",
+      "source": "./",
       "description": "Loads AGENTS.md files automatically into Claude Code sessions",
       "version": "1.0.0",
       "author": {
diff --git a/README.md b/README.md
index 00a638b..08c2087 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,39 @@ claude plugin marketplace add bendrucker/claude-code-agents-md
 claude plugin install agents-md
 ```
 
+## Known Issue
+
+Due to [a bug in Claude Code](https://github.com/anthropics/claude-code/issues/11509), plugin hooks are not registered. Until this is fixed, you must manually add the hooks to your user settings (`~/.claude/settings.json`):
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ~/.claude/plugins/cache/agents-md-marketplace/agents-md/1.0.0/agents-md-marketplace/.claude-plugin/hook.ts"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ~/.claude/plugins/cache/agents-md-marketplace/agents-md/1.0.0/agents-md-marketplace/.claude-plugin/hook.ts"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
 ## How It Works
 
 The plugin uses two hooks to inject `AGENTS.md` content into Claude Code sessions: