codex-xai-oauth 0.1.0 → 0.2.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-xai-oauth",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Use xAI/Grok OAuth or API-key credentials from Codex through local MCP tools.",
   "author": {
     "name": "ilseoblee"
@@ -13,15 +13,16 @@
   "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.",
+    "shortDescription": "Generate with Grok, including artifact-backed images, from Codex.",
+    "longDescription": "Adds local Codex MCP tools for xAI/Grok text, web search, X search, artifact-backed 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.",
+      "Use xai_image_generate with artifact_dir to generate an image and save local artifacts.",
       "Check my xAI credential status.",
-      "Search the web with Grok."
+      "Search the web with Grok.",
+      "Call the OpenAI-compatible /v1/images/generations proxy with n, resolution, size, and response_format."
     ],
     "brandColor": "#111111"
   }

package/README.md

@@ -13,7 +13,7 @@ Codex plugin that exposes xAI/Grok tools through a local stdio MCP server. It is
 - `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`.
+`xai_image_generate` calls xAI `/images/generations`. Default model is `grok-imagine-image`, default response format is `url`, and `resolution` supports `1k` or `2k`. Pass `artifact_dir` to save returned URL or `b64_json` images locally and include artifact metadata in the tool result.
 
 ## Unofficial / Use At Your Own Risk
 
@@ -81,6 +81,18 @@ Status:
 npx codex-xai-oauth status
 ```
 
+Generate an image directly from the NPX CLI:
+
+```bash
+npx codex-xai-oauth image --prompt "minimal blue dot icon" --resolution 2k
+```
+
+Save generated image payloads to local artifacts:
+
+```bash
+npx codex-xai-oauth image --prompt "minimal blue dot icon" --response-format b64_json --artifact-dir .codex-xai-artifacts
+```
+
 OAuth credentials are stored at:
 
 ```text
@@ -121,6 +133,8 @@ The proxy exposes:
 - `/v1/responses`
 - `/v1/images/generations`
 
+`/v1/images/generations` and `/images/generations` forward `prompt`, `model`, `n`, `size`, `resolution`, and `response_format`. Invalid `n`, `resolution`, or `response_format` values return a 400 response before any upstream xAI call.
+
 ## Codex Plugin Surface
 
 - `.codex-plugin/plugin.json` declares the plugin metadata, skill bundle, and MCP config.