Codex

diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 9873836..e29aec5 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -6,8 +6,8 @@
     "name": "NobGit",
     "url": "https://www.nobgit.com"
   },
-  "homepage": "https://www.nobgit.com",
-  "repository": "https://www.nobgit.com/nobgit/nobgit",
+  "homepage": "https://www.nobgit.com/nobgit/codex",
+  "repository": "https://www.nobgit.com/nobgit/codex",
   "license": "UNLICENSED",
   "keywords": [
     "nobgit",
@@ -24,6 +24,7 @@
     "longDescription": "NobGit helps Codex publish local work by checking repository state, adding or updating a NobGit remote, committing intended changes, and pushing branches to NobGit over HTTPS with the user's NobGit credentials or access token.",
     "developerName": "NobGit",
     "category": "Developer Tools",
+    "websiteURL": "https://www.nobgit.com/nobgit/codex",
     "capabilities": [
       "Source Control",
       "Git",
diff --git a/readme.md b/readme.md
index 9161e13..699c1e5 100644
--- a/readme.md
+++ b/readme.md
@@ -1,8 +1,103 @@
-## Install
-
-Clone this plugin into your Codex plugins folder:
-
-### Windows
-
-```powershell
-git clone https://nobgit.com/nobgit/codex.git "$env:USERPROFILE\.codex\plugins\nobgit"
\ No newline at end of file
+# NobGit for Codex
+
+Codex plugin for working with NobGit repositories. It adds a NobGit skill and
+connects Codex to the NobGit MCP server for repository discovery, repository
+metadata, repository trees/files, and issue operations.
+
+## Install
+
+Clone the plugin into your personal Codex plugin source folder:
+
+### Windows PowerShell
+
+```powershell
+git clone https://www.nobgit.com/nobgit/codex.git "$env:USERPROFILE\plugins\nobgit"
+
+$marketplacePath = "$env:USERPROFILE\.agents\plugins\marketplace.json"
+$marketplaceDir = Split-Path $marketplacePath
+New-Item -ItemType Directory -Force $marketplaceDir | Out-Null
+
+if (Test-Path $marketplacePath) {
+  $marketplace = Get-Content -Raw $marketplacePath | ConvertFrom-Json
+} else {
+  $marketplace = [ordered]@{
+    name = "personal"
+    interface = [ordered]@{ displayName = "Personal" }
+    plugins = @()
+  }
+}
+
+$entry = [ordered]@{
+  name = "nobgit"
+  source = [ordered]@{
+    source = "local"
+    path = "./plugins/nobgit"
+  }
+  policy = [ordered]@{
+    installation = "AVAILABLE"
+    authentication = "ON_INSTALL"
+  }
+  category = "Developer Tools"
+}
+
+$plugins = @($marketplace.plugins | Where-Object { $_.name -ne "nobgit" })
+$marketplace.plugins = @($plugins + $entry)
+$marketplace | ConvertTo-Json -Depth 10 | Set-Content -Encoding UTF8 $marketplacePath
+```
+
+### macOS or Linux
+
+```bash
+git clone https://www.nobgit.com/nobgit/codex.git "$HOME/plugins/nobgit"
+
+mkdir -p "$HOME/.agents/plugins"
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+marketplace_path = Path.home() / ".agents" / "plugins" / "marketplace.json"
+if marketplace_path.exists():
+    marketplace = json.loads(marketplace_path.read_text())
+else:
+    marketplace = {
+        "name": "personal",
+        "interface": {"displayName": "Personal"},
+        "plugins": [],
+    }
+
+entry = {
+    "name": "nobgit",
+    "source": {
+        "source": "local",
+        "path": "./plugins/nobgit",
+    },
+    "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL",
+    },
+    "category": "Developer Tools",
+}
+
+marketplace["plugins"] = [
+    plugin for plugin in marketplace.get("plugins", [])
+    if plugin.get("name") != "nobgit"
+] + [entry]
+marketplace_path.write_text(json.dumps(marketplace, indent=2) + "\n")
+PY
+```
+
+Then install it from the personal marketplace:
+
+```bash
+codex plugin add nobgit@personal
+```
+
+Start a new Codex thread after installing so the NobGit skill and MCP tools are
+loaded into the conversation.
+
+## Why the marketplace step matters
+
+Cloning this repository into a plugin folder can make the skill load locally, but
+Codex uses the marketplace entry to render the plugin in the Plugins UI. The
+entry above marks NobGit as available, names its local source path, and gives it
+the Developer Tools category.