diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 00000000000..a6b5dc28ea0
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,16 @@
+{
+  "name": "gemini-cli",
+  "version": "0.1.0",
+  "description": "An open-source AI agent that brings the power of Gemini directly into your terminal.",
+  "author": {
+    "name": "google-gemini",
+    "url": "https://github.com/google-gemini"
+  },
+  "homepage": "https://github.com/google-gemini/gemini-cli",
+  "repository": "https://github.com/google-gemini/gemini-cli",
+  "keywords": [
+    "mcp",
+    "codex"
+  ],
+  "mcpServers": "./.mcp.json"
+}
\ No newline at end of file
diff --git a/.github/workflows/codex-plugin-scanner.yml b/.github/workflows/codex-plugin-scanner.yml
new file mode 100644
index 00000000000..c1df010c474
--- /dev/null
+++ b/.github/workflows/codex-plugin-scanner.yml
@@ -0,0 +1,26 @@
+name: Codex Plugin Quality Gate
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: codex-plugin-scanner-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - name: Codex plugin scanner
+        uses: hashgraph-online/hol-codex-plugin-scanner-action@e83708a91ae4812872aa2905b99ad559a55c74ab
+        with:
+          plugin_dir: "."
+          mode: scan
+          fail_on_severity: critical
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 00000000000..7c1a2a4e162
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "node",
+      "args": [
+        "bundle/gemini.js"
+      ]
+    }
+  }
+}
\ No newline at end of file