codex-xai-oauth 0.1.0

package/.codex-plugin/plugin.json

@@ -0,0 +1,28 @@
+{
+  "name": "codex-xai-oauth",
+  "version": "0.1.0",
+  "description": "Use xAI/Grok OAuth or API-key credentials from Codex through local MCP tools.",
+  "author": {
+    "name": "ilseoblee"
+  },
+  "homepage": "https://github.com/islee23520/codex-xai-oauth",
+  "repository": "https://github.com/islee23520/codex-xai-oauth",
+  "license": "MIT",
+  "keywords": ["codex", "mcp", "xai", "grok", "oauth", "image-generation"],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "xAI Grok OAuth",
+    "shortDescription": "Generate with Grok, including images, from Codex.",
+    "longDescription": "Adds local Codex MCP tools for xAI/Grok text, web search, X search, image generation, TTS, video generation, and credential status using OAuth or XAI_API_KEY.",
+    "developerName": "ilseoblee",
+    "category": "Productivity",
+    "capabilities": ["MCP", "Local tools", "Image generation"],
+    "defaultPrompt": [
+      "Generate an image with xAI.",
+      "Check my xAI credential status.",
+      "Search the web with Grok."
+    ],
+    "brandColor": "#111111"
+  }
+}

package/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "xai-grok": {
+      "command": "node",
+      "args": ["./dist/mcp/server.js"],
+      "cwd": "."
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ilseoblee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# codex-xai-oauth
+
+Codex plugin that exposes xAI/Grok tools through a local stdio MCP server. It is based on the reusable OAuth and xAI client behavior from `../opencode-xai-oauth`, adapted for Codex plugin packaging instead of OpenCode provider hooks.
+
+## What Works
+
+- `xai_status`
+- `xai_login_instructions`
+- `xai_generate_text`
+- `xai_web_search`
+- `xai_x_search`
+- `xai_image_generate`
+- `xai_tts`
+- `xai_video_generate`
+
+`xai_image_generate` calls xAI `/images/generations`. Default model is `grok-imagine-image`, default response format is `url`, and `resolution` supports `1k` or `2k`.
+
+## Unofficial / Use At Your Own Risk
+
+This project is not affiliated with or endorsed by xAI. OAuth behavior and media endpoints can change. You are responsible for reviewing and complying with xAI terms, API policies, X policies, account rules, and quota or billing implications before using it.
+
+## Development
+
+```bash
+npm install
+npm test
+npm run typecheck
+npm run build
+python3 /Users/ilseoblee/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py .
+```
+
+## Install / Doctor
+
+From a checkout:
+
+```bash
+npm run setup
+npm run doctor
+```
+
+Via npx:
+
+```bash
+npx codex-xai-oauth setup
+npx codex-xai-oauth doctor
+```
+
+Globally from GitHub:
+
+```bash
+npm install -g github:islee23520/codex-xai-oauth
+codex-xai-oauth setup
+codex-xai-oauth doctor
+```
+
+`setup` syncs this package into the local `linalab` Codex marketplace and installs `codex-xai-oauth@linalab`. `doctor` checks the build output, Codex plugin install, MCP registration, and credential status.
+
+## Authentication
+
+Browser OAuth login:
+
+```bash
+npx codex-xai-oauth login
+```
+
+OAuth device flow for headless environments:
+
+```bash
+npx codex-xai-oauth login --device
+```
+
+API-key fallback:
+
+```bash
+export XAI_API_KEY=xai-...
+```
+
+Status:
+
+```bash
+npx codex-xai-oauth status
+```
+
+OAuth credentials are stored at:
+
+```text
+~/.config/codex-xai-oauth/auth.json
+```
+
+If that file is absent and no custom auth file is configured, the tools also read the Grok CLI OIDC session from:
+
+```text
+~/.grok/auth.json
+```
+
+Overrides:
+
+- `CODEX_XAI_OAUTH_AUTH_FILE`: custom OAuth auth JSON path.
+- `CODEX_XAI_OAUTH_GROK_AUTH_FILE`: custom Grok CLI auth JSON path, mainly for tests or nonstandard installs.
+- `XAI_API_KEY`: API-key fallback.
+- `XAI_BASE_URL`: custom xAI-compatible base URL.
+
+## OpenAI-Compatible Proxy
+
+After OAuth login, start a local `/v1` proxy backed by the stored xAI OAuth token:
+
+```bash
+npx codex-xai-oauth serve-openai --host 127.0.0.1 --port 8787
+```
+
+Print a CLIProxyAPIPlus `openai-compatibility` snippet:
+
+```bash
+npx codex-xai-oauth cliproxy-config
+```
+
+The proxy exposes:
+
+- `/v1/models`
+- `/v1/chat/completions`
+- `/v1/responses`
+- `/v1/images/generations`
+
+## Codex Plugin Surface
+
+- `.codex-plugin/plugin.json` declares the plugin metadata, skill bundle, and MCP config.
+- `.mcp.json` starts the stdio MCP server from `dist/mcp/server.js`.
+- `skills/xai-grok/SKILL.md` tells Codex when to use the tools and how to avoid leaking secrets.
+
+Build before installing or using the MCP server:
+
+```bash
+npm run build
+```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map