From 3380b6e900a8ee856871b4638caea66e07b501ec Mon Sep 17 00:00:00 2001
From: sajeetharan <sajeefx@gmail.com>
Date: Tue, 21 Jul 2026 23:01:26 +0530
Subject: [PATCH] docs: add Codex repo marketplace catalog

---
 .agents/plugins/marketplace.json | 20 ++++++++++++++++++++
 CHANGELOG.md                     |  5 +++++
 README.md                        | 14 ++++++++++++--
 3 files changed, 37 insertions(+), 2 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 0000000..6b7b14d
--- /dev/null
+++ b/.agents/plugins/marketplace.json
@@ -0,0 +1,20 @@
+{
+  "name": "azure-cosmosdb",
+  "interface": {
+    "displayName": "Azure Cosmos DB"
+  },
+  "plugins": [
+    {
+      "name": "azure-cosmosdb",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Databases"
+    }
+  ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a8b2996..857e3e5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,11 @@ This is the high-level log. For detailed per-iteration evaluation notes (test re
 
 ---
 
+## 2026-07-21 — Add Codex repo marketplace catalog
+
+- **New catalog:** `.agents/plugins/marketplace.json` — Codex-native repo marketplace listing the `azure-cosmosdb` plugin (`source.path: "./"`, `category: "Databases"`), so users can add it with `codex plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit`. Codex also reads the legacy `.claude-plugin/marketplace.json`. The catalog carries no package `version` (schema-only) and is intentionally excluded from `npm run version`.
+- **Docs:** README adds an OpenAI Codex CLI install section and updates the per-agent manifest table to reference both marketplace catalogs.
+
 ## v1.2.0 — 2026-07-21 — Add Kimi Code plugin surface
 
 - **New manifest:** `.kimi-plugin/plugin.json` — Official Kimi Code plugin for Azure Cosmos DB, bundling the skills (`./skills/`) and the Azure MCP server (`@azure/mcp`). Mirrors the Codex `interface` block (display name, category, default prompts, brand color).
diff --git a/README.md b/README.md
index 4b6cba2..dc46959 100644
--- a/README.md
+++ b/README.md
@@ -112,14 +112,24 @@ Or add the custom marketplace catalog, then install from the plugin manager (`/p
 
 The plugin manifest lives at `.kimi-plugin/plugin.json` and the catalog at `kimi-marketplace.json`.
 
+### OpenAI Codex CLI
+
+Add the repo marketplace, then install from the Plugins Directory in the ChatGPT desktop app:
+
+```
+codex plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit
+```
+
+The plugin manifest lives at `.codex-plugin/plugin.json` and the marketplace catalog at `.agents/plugins/marketplace.json` (Codex also reads the legacy `.claude-plugin/marketplace.json`).
+
 ### Per-agent plugin directories
 
 The repository includes ready-made plugin manifests:
 
 | Agent | Manifest |
 |-------|----------|
-| Claude Code | `.claude-plugin/plugin.json` |
-| OpenAI Codex | `.codex-plugin/plugin.json` |
+| Claude Code | `.claude-plugin/plugin.json` + `.claude-plugin/marketplace.json` |
+| OpenAI Codex | `.codex-plugin/plugin.json` + `.agents/plugins/marketplace.json` |
 | Cursor | `.cursor-plugin/plugin.json` |
 | Gemini CLI | `gemini-extension.json` + `GEMINI.md` |
 | Kimi Code | `.kimi-plugin/plugin.json` |