diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index aad0152..af31817 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "claude-obsidian: Claude + Obsidian knowledge companion by AgriciDaniel",
-    "version": "1.4.0"
+    "version": "1.4.1"
   },
   "plugins": [
     {
@@ -17,7 +17,7 @@
         "ref": "main"
       },
       "description": "Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects.",
-      "version": "1.4.0",
+      "version": "1.4.1",
       "author": {
         "name": "AgriciDaniel",
         "url": "https://github.com/AgriciDaniel"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 5687579..66e4b29 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "claude-obsidian",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects. Based on Andrej Karpathy's LLM Wiki pattern.",
   "author": {
     "name": "AgriciDaniel",
diff --git a/README.md b/README.md
index 769ef37..177d1c9 100644
--- a/README.md
+++ b/README.md
@@ -52,12 +52,23 @@ Open Claude Code in the same folder. Type `/wiki`.
 
 ### Option 2: Install as Claude Code plugin
 
+Plugin installation is a two-step process in Claude Code. First add the marketplace catalog, then install the plugin from it.
+
 ```bash
-claude plugin install github:AgriciDaniel/claude-obsidian
+# Step 1: add the marketplace
+claude plugin marketplace add AgriciDaniel/claude-obsidian
+
+# Step 2: install the plugin
+claude plugin install claude-obsidian@claude-obsidian-marketplace
 ```
 
 In any Claude Code session: `/wiki`. Claude walks you through vault setup.
 
+To check it worked:
+```bash
+claude plugin list
+```
+
 ---
 
 ### Option 3: Add to an existing vault
diff --git a/docs/install-guide.md b/docs/install-guide.md
index 40bb5e3..df2f345 100644
--- a/docs/install-guide.md
+++ b/docs/install-guide.md
@@ -39,13 +39,24 @@ Then in Obsidian: **Manage Vaults → Open folder as vault → select `claude-ob
 
 Open Claude Code in the same folder and type `/wiki`.
 
-### Option 2 — Install as Claude Code plugin
+### Option 2: Install as Claude Code plugin
+
+Plugin installation in Claude Code is a two-step process. First add the marketplace catalog, then install the plugin from it.
 
 ```bash
-claude plugin install github:AgriciDaniel/claude-obsidian
+# Step 1: add the marketplace
+claude plugin marketplace add AgriciDaniel/claude-obsidian
+
+# Step 2: install the plugin
+claude plugin install claude-obsidian@claude-obsidian-marketplace
 ```
 
-In any Claude Code session: type `/wiki` — Claude walks you through vault setup.
+Verify the install:
+```bash
+claude plugin list
+```
+
+In any Claude Code session: type `/wiki` and Claude walks you through vault setup.
 
 ### Option 3 — Add to an existing vault