From e3136a0c5b209c4b9b5a29843d739bfc399f4874 Mon Sep 17 00:00:00 2001
From: AreChen <cmx278171032@163.com>
Date: Wed, 10 Jun 2026 14:50:33 +0800
Subject: [PATCH] Let Codex discover the marketplace from the repository root

Constraint: Codex Git sparse checkout preserves selected paths, so plugins/codex is not treated as the marketplace root by the CLI.\nRejected: Require users to rely on a single plugins/codex sparse path | The CLI leaves the manifest nested and rejects the marketplace root.\nConfidence: high\nScope-risk: narrow\nDirective: Keep the root .agents/plugins/marketplace.json as the primary Git entrypoint.\nTested: python json.tool on both marketplace manifests; validate_plugin.py.\nNot-tested: Remote Git marketplace add after this commit.
---
 .agents/plugins/marketplace.json | 20 ++++++++++++++++++++
 README.md                        | 21 ++++++++++++++++++---
 plugins/codex/README.md          |  8 ++++----
 3 files changed, 42 insertions(+), 7 deletions(-)
 create mode 100644 .agents/plugins/marketplace.json

diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
new file mode 100644
index 000000000..8d7b42b0f
--- /dev/null
+++ b/.agents/plugins/marketplace.json
@@ -0,0 +1,20 @@
+{
+  "name": "eapil-skill-market",
+  "interface": {
+    "displayName": "EAPIL Skill Market"
+  },
+  "plugins": [
+    {
+      "name": "eapil-skills",
+      "source": {
+        "source": "local",
+        "path": "./plugins/codex/plugins/eapil-skills"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}
diff --git a/README.md b/README.md
index 1a5b7b2ab..31431af56 100644
--- a/README.md
+++ b/README.md
@@ -8,21 +8,35 @@ In **Add plugin marketplace**:
 
 - Source: `https://git.playones.com/arechen/EapilSkillMarket.git`
 - Git ref: `main`
-- Sparse path: `plugins/codex`
+- Sparse path: leave empty
 
 After the marketplace is added, install `eapil-skills` from the `EAPIL Skill Market` marketplace.
 
+If you want to use sparse checkout, enter both paths if the UI allows multiple lines:
+
+```text
+.agents
+plugins/codex
+```
+
 ## CLI test
 
 ```powershell
-codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main --sparse plugins/codex
+codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main
+codex plugin add eapil-skills@eapil-skill-market
+```
+
+Sparse CLI form:
+
+```powershell
+codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main --sparse .agents --sparse plugins/codex
 codex plugin add eapil-skills@eapil-skill-market
 ```
 
 For local testing before pushing:
 
 ```powershell
-codex plugin marketplace add .\plugins\codex
+codex plugin marketplace add .
 codex plugin add eapil-skills@eapil-skill-market
 ```
 
@@ -31,6 +45,7 @@ Start a new Codex thread after installing so the new skills are loaded into cont
 ## Layout
 
 ```text
+.agents/plugins/marketplace.json
 plugins/codex/
   .agents/plugins/marketplace.json
   plugins/eapil-skills/
diff --git a/plugins/codex/README.md b/plugins/codex/README.md
index c167bc468..99ded5600 100644
--- a/plugins/codex/README.md
+++ b/plugins/codex/README.md
@@ -1,9 +1,9 @@
 # Codex Marketplace Root
 
-Use this directory as the Git sparse path for Codex:
+This directory can be used as a local marketplace root:
 
-```text
-plugins/codex
+```powershell
+codex plugin marketplace add .\plugins\codex
 ```
 
-It contains `.agents/plugins/marketplace.json` and the `plugins/eapil-skills` plugin source expected by Codex.
+For Git marketplace testing from the repository root, prefer the root `.agents/plugins/marketplace.json` entry and leave sparse checkout empty.