imgx-cli 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.5.2 (2026-02-26)
+
+### Fixed
+
+- `imgx-mcp` bin: added missing shebang (`#!/usr/bin/env node`) — fixes `npx imgx-mcp` and Claude Desktop MCP integration on all platforms
+
+### Changed
+
+- README: add Claude Desktop MCP configuration (Windows `cmd /c` + macOS/Linux)
+- README: switch all MCP config examples from local `node` path to `npx`
+- README: replace "Version updates" with full release checklist (version bump → build → publish → verify)
+
 ## 0.5.1 (2026-02-26)
 
 ### Added
@@ -10,6 +22,7 @@
 
 ### Changed
 
+- README: added Claude Desktop MCP configuration section with output directory note
 - README: added Google AI Studio link for API key setup, MCP env section note
 
 ## 0.5.0 (2026-02-26)

package/README.md

@@ -2,8 +2,6 @@
 
 AI image generation and editing from the terminal. Provider-agnostic design with capability-based abstraction.
 
-<!-- TODO: Add demo GIF showing generate → edit → edit --last workflow -->
-
 ## Install
 
 ### As a Claude Code plugin
@@ -206,38 +204,76 @@ Add to your tool's MCP config. The `env` section is optional if you have already
 {
   "mcpServers": {
     "imgx": {
-      "command": "node",
-      "args": ["/path/to/imgx-cli/dist/mcp.bundle.js"],
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
       "env": { "GEMINI_API_KEY": "your-api-key" }
     }
   }
 }
 ```
 
+On Windows, replace `"command": "npx"` with `"command": "cmd"` and prepend `"/c"` to the args array.
+
+Or install as a [Claude Code plugin](#install) for automatic MCP registration.
+
 **Gemini CLI** (`~/.gemini/settings.json`):
 
 ```json
 {
   "mcpServers": {
     "imgx": {
-      "command": "node",
-      "args": ["/path/to/imgx-cli/dist/mcp.bundle.js"],
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
+      "env": { "GEMINI_API_KEY": "your-api-key" }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+macOS / Linux:
+
+```json
+{
+  "mcpServers": {
+    "imgx": {
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
+      "env": { "GEMINI_API_KEY": "your-api-key" }
+    }
+  }
+}
+```
+
+Windows:
+
+```json
+{
+  "mcpServers": {
+    "imgx": {
+      "command": "cmd",
+      "args": ["/c", "npx", "--package=imgx-cli", "-y", "imgx-mcp"],
       "env": { "GEMINI_API_KEY": "your-api-key" }
     }
   }
 }
 ```
 
+Config file location: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS). After editing, restart Claude Desktop.
+
+> **Note:** Claude Desktop runs the MCP server from its own app directory. Images will be saved there by default. To control the output location, add `"IMGX_OUTPUT_DIR": "C:\\Users\\you\\Pictures"` to the `env` section, or run `imgx config set output-dir <path>` beforehand.
+
 **Codex CLI** (`.codex/config.toml`):
 
 ```toml
 [mcp_servers.imgx]
-command = "node"
-args = ["/path/to/imgx-cli/dist/mcp.bundle.js"]
+command = "npx"
+args = ["--package=imgx-cli", "-y", "imgx-mcp"]
 env = { GEMINI_API_KEY = "your-api-key" }
 ```
 
-The same configuration pattern works with Cursor, Windsurf, Continue.dev, Cline, Zed, and other MCP-compatible tools.
+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.
 
 ## Architecture
 
@@ -273,56 +309,6 @@ Each provider declares its supported capabilities. The CLI dynamically enables o
 |----------|--------|-------------|
 | Gemini | `gemini-3-pro-image-preview`, `gemini-2.5-flash-image` | All 7 capabilities |
 
-## Plugin structure
-
-imgx-cli doubles as an AI coding tool plugin. The repository contains:
-
-```
-.claude-plugin/
-├── plugin.json          # Claude Code plugin manifest
-└── marketplace.json     # Marketplace definition for plugin discovery
-.cursor-plugin/
-└── plugin.json          # Cursor plugin manifest
-.mcp.json                # MCP server config (auto-registered on plugin install)
-skills/
-└── image-generation/
-    ├── SKILL.md         # Skill instructions
-    └── references/
-        └── providers.md # Provider and model reference
-dist/
-├── cli.bundle.js        # Bundled CLI (tracked in git for plugin distribution)
-└── mcp.bundle.js        # Bundled MCP server
-```
-
-When installed as a plugin, the tool clones this repository and registers the skill. The skill instructs the AI to execute `dist/cli.bundle.js` via bash when image generation or editing is requested.
-
-### Plugin configuration files
-
-**`.claude-plugin/plugin.json`** — Plugin identity. Fields: `name`, `description`, `version`, `author`. No `category` field (that belongs in `marketplace.json` only).
-
-**`.claude-plugin/marketplace.json`** — Marketplace wrapper. The `source` field must use URL format for self-referencing repositories:
-
-```json
-"source": {
-  "source": "url",
-  "url": "https://github.com/somacoffeekyoto/imgx-cli.git"
-}
-```
-
-**`skills/image-generation/SKILL.md`** — Uses `${CLAUDE_PLUGIN_ROOT}` variable for portable CLI paths. Frontmatter (`name`, `description`) is required for skill registration.
-
-### Version updates
-
-When releasing a new version, update the version string in all locations:
-
-1. `package.json` — npm package version
-2. `src/cli/index.ts` — CLI `--version` output
-3. `.claude-plugin/plugin.json` — Claude Code plugin manifest version
-4. `.claude-plugin/marketplace.json` — Marketplace plugin entry version
-5. `.cursor-plugin/plugin.json` — Cursor plugin manifest version
-
-Then rebuild (`npm run bundle`) and commit `dist/cli.bundle.js` since plugin distribution relies on the git repository.
-
 ## Development
 
 ```bash