imgx-cli 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.6.1 (2026-02-27)
+
+### Fixed
+
+- Default output directory changed from process cwd to `~/Pictures/imgx` — fixes images being saved to AppData when used via MCP (Claude Desktop, etc.)
+
+## 0.6.0 (2026-02-27)
+
+### Added
+
+- **OpenAI provider** — `gpt-image-1` model with generate and edit support
+  - Native `fetch` implementation (no `openai` npm dependency)
+  - Aspect ratio mapping to OpenAI size strings, resolution mapping to quality parameter
+  - Manual multipart/form-data construction for Node 18 compatibility
+- `OPENAI_API_KEY` environment variable support
+- `--provider` flag for `imgx config set api-key` — manage API keys per provider
+  - `imgx config set api-key <key> --provider openai`
+  - `imgx config list` now shows all configured provider keys
+
+### Changed
+
+- CLI and MCP server now initialize both Gemini and OpenAI providers at startup
+- `imgx providers` and error messages updated for multi-provider context
+- Help text updated with OpenAI provider info and env var
+
 ## 0.5.2 (2026-02-26)
 
 ### Fixed

package/README.md

@@ -48,16 +48,25 @@ Requires Node.js 18+.
 
 ## Setup
 
-Get a Gemini API key from [Google AI Studio](https://aistudio.google.com/apikey) (free tier available), then save it:
+Set up at least one provider:
+
+**Gemini** — get a key from [Google AI Studio](https://aistudio.google.com/apikey) (free tier available):
+
+```bash
+imgx config set api-key YOUR_GEMINI_API_KEY --provider gemini
+```
+
+**OpenAI** — get a key from [OpenAI Platform](https://platform.openai.com/api-keys):
 
 ```bash
-imgx config set api-key YOUR_GEMINI_API_KEY
+imgx config set api-key YOUR_OPENAI_API_KEY --provider openai
 ```
 
-This stores the key in `~/.config/imgx/config.json` (Linux/macOS) or `%APPDATA%\imgx\config.json` (Windows). Alternatively, set an environment variable:
+Keys are stored in `~/.config/imgx/config.json` (Linux/macOS) or `%APPDATA%\imgx\config.json` (Windows). Alternatively, set environment variables:
 
 ```bash
 export GEMINI_API_KEY="your-api-key"
+export OPENAI_API_KEY="your-api-key"
 ```
 
 Environment variables take precedence over the config file.
@@ -106,7 +115,8 @@ imgx edit --last -p "Crop to 16:9" -o final.png
 ### Configuration
 
 ```bash
-imgx config set api-key <key>     # Save Gemini API key
+imgx config set api-key <key> --provider gemini   # Save Gemini API key
+imgx config set api-key <key> --provider openai   # Save OpenAI API key
 imgx config set model <name>      # Set default model
 imgx config set output-dir <dir>  # Set default output directory
 imgx config set aspect-ratio 16:9 # Set default aspect ratio
@@ -162,7 +172,8 @@ Environment variables override config file settings.
 
 | Variable | Description |
 |----------|-------------|
-| `GEMINI_API_KEY` | Gemini API key (overrides `imgx config set api-key`) |
+| `GEMINI_API_KEY` | Gemini API key |
+| `OPENAI_API_KEY` | OpenAI API key |
 | `IMGX_PROVIDER` | Default provider |
 | `IMGX_MODEL` | Default model |
 | `IMGX_OUTPUT_DIR` | Default output directory |
@@ -206,7 +217,7 @@ Add to your tool's MCP config. The `env` section is optional if you have already
     "imgx": {
       "command": "npx",
       "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
-      "env": { "GEMINI_API_KEY": "your-api-key" }
+      "env": { "GEMINI_API_KEY": "your-key", "OPENAI_API_KEY": "your-key" }
     }
   }
 }
@@ -224,7 +235,7 @@ Or install as a [Claude Code plugin](#install) for automatic MCP registration.
     "imgx": {
       "command": "npx",
       "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
-      "env": { "GEMINI_API_KEY": "your-api-key" }
+      "env": { "GEMINI_API_KEY": "your-key", "OPENAI_API_KEY": "your-key" }
     }
   }
 }
@@ -240,7 +251,7 @@ macOS / Linux:
     "imgx": {
       "command": "npx",
       "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
-      "env": { "GEMINI_API_KEY": "your-api-key" }
+      "env": { "GEMINI_API_KEY": "your-key", "OPENAI_API_KEY": "your-key" }
     }
   }
 }
@@ -254,7 +265,7 @@ Windows:
     "imgx": {
       "command": "cmd",
       "args": ["/c", "npx", "--package=imgx-cli", "-y", "imgx-mcp"],
-      "env": { "GEMINI_API_KEY": "your-api-key" }
+      "env": { "GEMINI_API_KEY": "your-key", "OPENAI_API_KEY": "your-key" }
     }
   }
 }
@@ -270,11 +281,13 @@ Config file location: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or
 [mcp_servers.imgx]
 command = "npx"
 args = ["--package=imgx-cli", "-y", "imgx-mcp"]
-env = { GEMINI_API_KEY = "your-api-key" }
+env = { GEMINI_API_KEY = "your-key", OPENAI_API_KEY = "your-key" }
 ```
 
 The same `npx` pattern works with Cursor, Windsurf, Continue.dev, Cline, Zed, and other MCP-compatible tools. On Windows, use `cmd /c npx` instead of `npx` directly.
 
+Only include the API keys for providers you want to use. At least one is required.
+
 ## Architecture
 
 imgx separates **model-independent** and **model-dependent** concerns:
@@ -308,6 +321,7 @@ Each provider declares its supported capabilities. The CLI dynamically enables o
 | Provider | Models | Capabilities |
 |----------|--------|-------------|
 | Gemini | `gemini-3-pro-image-preview`, `gemini-2.5-flash-image` | All 7 capabilities |
+| OpenAI | `gpt-image-1` | Generate, edit, aspect ratio, multi-output |
 
 ## Development
 

package/dist/cli.bundle.js

@@ -39210,8 +39210,9 @@ function getApiKeyFromEnv() {
 
 // build/core/storage.js
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
-import { dirname, resolve as resolve2 } from "node:path";
+import { dirname, join as join2, resolve as resolve2 } from "node:path";
 import { randomUUID } from "node:crypto";
+import { homedir as homedir2 } from "node:os";
 var MIME_TO_EXT = {
   "image/png": ".png",
   "image/jpeg": ".jpg",
@@ -39224,9 +39225,17 @@ function readImageAsBase64(filePath) {
   const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : ext === "webp" ? "image/webp" : "image/png";
   return { data: buffer.toString("base64"), mimeType };
 }
+function fallbackOutputDir(outputDir) {
+  if (outputDir)
+    return outputDir;
+  const configured = resolveDefault("outputDir");
+  if (configured)
+    return configured;
+  return join2(homedir2(), "Pictures", "imgx");
+}
 function saveImage(image, outputPath, outputDir) {
   const ext = MIME_TO_EXT[image.mimeType] || ".png";
-  const filePath = outputPath ? resolve2(outputPath) : resolve2(outputDir || ".", `imgx-${randomUUID().slice(0, 8)}${ext}`);
+  const filePath = outputPath ? resolve2(outputPath) : resolve2(fallbackOutputDir(outputDir), `imgx-${randomUUID().slice(0, 8)}${ext}`);
   mkdirSync2(dirname(filePath), { recursive: true });
   writeFileSync2(filePath, image.data);
   return filePath;
@@ -39760,7 +39769,7 @@ function showAll() {
 }
 
 // build/cli/index.js
-var VERSION2 = "0.6.0";
+var VERSION2 = "0.6.1";
 var HELP = `imgx v${VERSION2} \u2014 AI image generation and editing CLI
 
 Commands:

package/dist/mcp.bundle.js

@@ -52131,6 +52131,28 @@ function resolveApiKey(providerName) {
   const config2 = loadConfig();
   return config2.providers?.[providerName]?.apiKey;
 }
+function loadProjectConfig() {
+  try {
+    const raw = readFileSync(resolve(".imgxrc"), "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function resolveDefault(key) {
+  const envMap = {
+    provider: process.env.IMGX_PROVIDER,
+    model: process.env.IMGX_MODEL,
+    outputDir: process.env.IMGX_OUTPUT_DIR
+  };
+  if (envMap[key])
+    return envMap[key];
+  const project = loadProjectConfig();
+  if (project.defaults?.[key])
+    return project.defaults[key];
+  const config2 = loadConfig();
+  return config2.defaults?.[key];
+}
 function saveLastOutput(filePaths) {
   const dir = configDir();
   mkdirSync(dir, { recursive: true });
@@ -69226,8 +69248,9 @@ function getApiKeyFromEnv() {
 
 // build/core/storage.js
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
-import { dirname, resolve as resolve2 } from "node:path";
+import { dirname, join as join2, resolve as resolve2 } from "node:path";
 import { randomUUID } from "node:crypto";
+import { homedir as homedir2 } from "node:os";
 var MIME_TO_EXT = {
   "image/png": ".png",
   "image/jpeg": ".jpg",
@@ -69240,9 +69263,17 @@ function readImageAsBase64(filePath) {
   const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : ext === "webp" ? "image/webp" : "image/png";
   return { data: buffer.toString("base64"), mimeType };
 }
+function fallbackOutputDir(outputDir) {
+  if (outputDir)
+    return outputDir;
+  const configured = resolveDefault("outputDir");
+  if (configured)
+    return configured;
+  return join2(homedir2(), "Pictures", "imgx");
+}
 function saveImage(image, outputPath, outputDir) {
   const ext = MIME_TO_EXT[image.mimeType] || ".png";
-  const filePath = outputPath ? resolve2(outputPath) : resolve2(outputDir || ".", `imgx-${randomUUID().slice(0, 8)}${ext}`);
+  const filePath = outputPath ? resolve2(outputPath) : resolve2(fallbackOutputDir(outputDir), `imgx-${randomUUID().slice(0, 8)}${ext}`);
   mkdirSync2(dirname(filePath), { recursive: true });
   writeFileSync2(filePath, image.data);
   return filePath;
@@ -69563,7 +69594,7 @@ function initOpenAI() {
 // build/mcp/server.js
 var server = new McpServer({
   name: "imgx",
-  version: "0.6.0"
+  version: "0.6.1"
 });
 initGemini();
 initOpenAI();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imgx-cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "mcpName": "io.github.somacoffeekyoto/imgx",
   "description": "AI image generation and editing CLI with provider abstraction",
   "type": "module",