imgx-mcp 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,10 +1,23 @@
 # Changelog
 
+## 1.0.4 (2026-03-03)
+
+### Added
+
+- **Skill ZIP for Claude Desktop** — `dist/image-generation-skill.zip` for uploading via Settings > Profile > Customize > Skills. Included in npm package under `dist/`
+- **`build:skill-zip` npm script** — `python scripts/build-skill-zip.py` generates the ZIP with forward-slash paths and ZIP_DEFLATED compression
+
+## 1.0.3 (2026-03-03)
+
+### Fixed
+
+- **`clear_history` directory removal** — `rmSync()` does not remove directories; replaced with `rmdirSync()` in both MCP server and CLI to correctly remove empty session directories after file deletion
+
 ## 1.0.2 (2026-03-03)
 
 ### Fixed
 
-- **v1.0.1 published with stale bundles** — `npm run bundle` (esbuild) was not run before `npm publish`, so v1.0.1 contained old `dist/mcp.bundle.js`. v1.0.2 is the correct release with all fixes below
+- **v1.0.1 published with stale bundles** — `npm run bundle` (esbuild) was not run before `npm publish`, so v1.0.1 contained old `dist/mcp.bundle.js`. v1.0.2 is the correct release with session outputDir inheritance fix
 
 ## 1.0.1 (2026-03-03) [YANKED — published with stale bundles]
 

package/README.md

@@ -60,6 +60,16 @@ The skill files are included in the [npm package](https://www.npmjs.com/package/
 
 > **Personal skill** (all projects): Place in `~/.claude/skills/image-generation/` instead of `.claude/skills/`.
 
+### Claude Desktop
+
+Claude Desktop supports skills via ZIP upload:
+
+1. Download [`image-generation-skill.zip`](dist/image-generation-skill.zip) from the repository (or find it in the [npm package](https://www.npmjs.com/package/imgx-mcp) under `dist/`)
+2. In Claude Desktop: **Settings > Profile > Customize > Skills > Add Skill**
+3. Upload the ZIP
+
+> Update the skill by re-downloading and re-uploading the ZIP after new releases.
+
 ### What the skill does
 
 The skill guides Claude Code through image workflows: blog covers, iterative editing, provider comparison, icon generation. It knows the MCP tool parameters and best practices, so you get better results with less effort.
@@ -69,7 +79,7 @@ The skill guides Claude Code through image workflows: blog covers, iterative edi
 | | MCP server | Skill |
 |---|---|---|
 | What it does | Exposes image tools to AI agents | Guided prompt for using the tools |
-| Works with | Any MCP-compatible tool | Claude Code |
+| Works with | Any MCP-compatible tool | Claude Code, Claude Desktop |
 | Install | Add to `.mcp.json` | Copy skill files to project |
 | Team sharing | Commit `.mcp.json` to repo | Commit `.claude/skills/` to repo |
 
@@ -82,9 +92,15 @@ The skill guides Claude Code through image workflows: blog covers, iterative edi
 | `generate_image` | Generate an image from a text prompt |
 | `edit_image` | Edit an existing image with text instructions |
 | `edit_last` | Edit the last generated/edited image (no input path needed) |
+| `undo_edit` | Undo the last edit, reverting to the previous image in the session |
+| `redo_edit` | Redo a previously undone edit |
+| `edit_history` | Show all sessions and their edit history with metadata |
+| `switch_session` | Switch to a different editing session |
+| `clear_history` | Clear all history (optionally delete image files) |
+| `set_output_dir` | Change the default output directory (optionally move existing files) |
 | `list_providers` | List available providers and capabilities |
 
-Images are saved to `~/Pictures/imgx/` by default. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
+Images are saved to `~/Pictures/imgx/<session-id>/` by default. Each session gets its own directory. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
 
 ### Iterative editing
 
@@ -98,6 +114,27 @@ The `edit_last` tool uses the output of the previous `generate_image` or `edit_i
 
 No need to specify file paths between steps.
 
+### Session management
+
+Each `generate_image` call starts a new session. Subsequent `edit_last` calls are added to the same session, forming an edit chain. Each session has its own output directory.
+
+**Undo / Redo** — Step backward and forward through the edit chain:
+
+```
+generate → edit_last → edit_last → edit_last
+                                    ↑ current
+                       ← undo_edit
+                       ↑ current
+                            redo_edit →
+                                    ↑ current
+```
+
+After undo, calling `edit_last` branches from the current position (newer entries are discarded).
+
+**Session switching** — Use `edit_history` to see all sessions, then `switch_session` to resume a previous session. The `edit_last` tool will use the current position in the switched session.
+
+**Output directory** — `edit_last` inherits the output directory from the session. If `generate_image` was called with `output_dir`, all subsequent `edit_last` calls in that session output to the same directory.
+
 ## API key setup
 
 Set up at least one provider:
@@ -222,7 +259,7 @@ imgx separates **model-independent** and **model-dependent** concerns:
 ```
 MCP server (tool definitions, stdio transport)    CLI (argument parsing, output formatting)
  ↓                                                 ↓
-Core (Capability enum, ImageProvider interface, provider registry, file I/O)
+Core (Capability enum, ImageProvider interface, provider registry, file I/O, history)
  ↓
 Provider (model-specific API calls, capability declarations)
 ```
@@ -270,6 +307,17 @@ imgx edit -i photo.png -p "Make the background darker"
 imgx edit --last -p "Add warm lighting"
 imgx edit --last -p "Crop to 16:9" -o final.png
 
+# Undo / redo
+imgx undo               # Revert to previous image in session
+imgx redo               # Re-apply an undone edit
+
+# History
+imgx history            # Show all sessions and entries
+imgx history switch <session-id>  # Switch to a different session
+imgx history clear      # Clear all history (interactive)
+imgx history clear --yes          # Clear without confirmation
+imgx history clear --keep-files   # Clear history but keep image files
+
 # Provider management
 imgx providers          # List providers and capabilities
 imgx capabilities       # Detailed capabilities of current provider

package/dist/cli.bundle.js

@@ -40016,7 +40016,7 @@ function showAll() {
 
 // build/cli/commands/history.js
 import { createInterface as createInterface2 } from "node:readline";
-import { rmSync as rmSync2, existsSync as existsSync3 } from "node:fs";
+import { rmSync as rmSync2, rmdirSync, existsSync as existsSync3 } from "node:fs";
 import { dirname as dirname2 } from "node:path";
 function runHistory(args) {
   const sub = args[0];
@@ -40102,7 +40102,7 @@ function deleteSessionFiles(filePaths) {
   }
   for (const dir of dirs) {
     try {
-      rmSync2(dir, { recursive: false });
+      rmdirSync(dir);
     } catch {
     }
   }
@@ -40138,7 +40138,7 @@ function runRedo() {
 }
 
 // build/cli/index.js
-var VERSION2 = "1.0.2";
+var VERSION2 = "1.0.4";
 var HELP = `imgx v${VERSION2} \u2014 AI image generation and editing for MCP-compatible AI agents
 
 Commands:

package/dist/mcp.bundle.js

@@ -69820,7 +69820,7 @@ function buildImageContent(images, paths, extra) {
 }
 var server = new McpServer({
   name: "imgx",
-  version: "1.0.2"
+  version: "1.0.4"
 });
 initGemini();
 initOpenAI();
@@ -70039,7 +70039,7 @@ server.tool("clear_history", "Clear all edit history. Optionally delete image fi
     const result = clearHistory();
     let filesDeleted = 0;
     if (args.delete_files) {
-      const { existsSync, rmSync } = await import("node:fs");
+      const { existsSync, rmSync, rmdirSync } = await import("node:fs");
       const { dirname: dirname2 } = await import("node:path");
       const dirs = /* @__PURE__ */ new Set();
       for (const fp of result.filePaths) {
@@ -70054,7 +70054,7 @@ server.tool("clear_history", "Clear all edit history. Optionally delete image fi
       }
       for (const dir of dirs) {
         try {
-          rmSync(dir);
+          rmdirSync(dir);
         } catch {
         }
       }

package/package.json

@@ -1,60 +1,62 @@
-{
-  "name": "imgx-mcp",
-  "version": "1.0.2",
-  "mcpName": "io.github.somacoffeekyoto/imgx",
-  "description": "AI image generation and editing for Claude Code, Codex CLI, and MCP-compatible AI agents",
-  "type": "module",
-  "bin": {
-    "imgx": "dist/cli.bundle.js",
-    "imgx-mcp": "dist/mcp.bundle.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "bundle": "npm run build && node esbuild.config.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "keywords": [
-    "image-generation",
-    "image-editing",
-    "gemini",
-    "openai",
-    "ai",
-    "mcp",
-    "skill",
-    "claude-code",
-    "cli"
-  ],
-  "author": "SOMA COFFEE KYOTO",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/somacoffeekyoto/imgx-mcp.git"
-  },
-  "homepage": "https://somacoffee.net/imgx-mcp/",
-  "bugs": {
-    "url": "https://github.com/somacoffeekyoto/imgx-mcp/issues"
-  },
-  "files": [
-    "dist/cli.bundle.js",
-    "dist/mcp.bundle.js",
-    "skills/",
-    "LICENSE",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@google/genai": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.27.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "esbuild": "^0.27.0",
-    "typescript": "^5.4.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "imgx-mcp",
+  "version": "1.0.4",
+  "mcpName": "io.github.somacoffeekyoto/imgx",
+  "description": "AI image generation and editing for Claude Code, Codex CLI, and MCP-compatible AI agents",
+  "type": "module",
+  "bin": {
+    "imgx": "dist/cli.bundle.js",
+    "imgx-mcp": "dist/mcp.bundle.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "bundle": "npm run build && node esbuild.config.js",
+    "dev": "tsc --watch",
+    "build:skill-zip": "python scripts/build-skill-zip.py",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "image-generation",
+    "image-editing",
+    "gemini",
+    "openai",
+    "ai",
+    "mcp",
+    "skill",
+    "claude-code",
+    "cli"
+  ],
+  "author": "SOMA COFFEE KYOTO",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/somacoffeekyoto/imgx-mcp.git"
+  },
+  "homepage": "https://somacoffee.net/imgx-mcp/",
+  "bugs": {
+    "url": "https://github.com/somacoffeekyoto/imgx-mcp/issues"
+  },
+  "files": [
+    "dist/cli.bundle.js",
+    "dist/mcp.bundle.js",
+    "dist/image-generation-skill.zip",
+    "skills/",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.27.0",
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.18"
+  }
+}