imgx-mcp 1.0.3 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 1.1.0 (2026-03-04)
+
+### Added
+
+- **Project-scoped history** — When `.imgxrc` exists, history is saved to `<project-root>/.imgx/output-history.json` instead of the global `%APPDATA%/imgx/` (or `~/.config/imgx/`). Each project gets its own independent edit history. Falls back to global when no `.imgxrc` is found
+- **`findProjectRoot()`** — Walks up from CWD to find `.imgxrc`, with `IMGX_PROJECT_ROOT` env var override and result caching
+- **`resolveProjectPath()`** — Resolves relative paths against the project root (or CWD if no project)
+- **`clearGlobalHistory()`** — Explicitly clears the global history store, separate from project history
+- **CLI `history clear --all`** — Clears both project and global history with mandatory interactive confirmation (cannot be skipped with `--yes`)
+- 17 new tests for project root detection, project-scoped history, and path resolution (total: 54 tests)
+
+### Changed
+
+- **`clear_history` (MCP)** now scopes to the current project automatically
+- **Relative path resolution** — `saveImage()`, `readImageAsBase64()`, `fallbackOutputDir()`, and OpenAI `edit()` now resolve relative paths against the project root instead of the MCP server's CWD
+- **`loadProjectConfig()`** uses `findProjectRoot()` to locate `.imgxrc` from ancestor directories, not just CWD
+
+## 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

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 project 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,18 @@ 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 project history (interactive)
+imgx history clear --yes          # Clear without confirmation
+imgx history clear --keep-files   # Clear history but keep image files
+imgx history clear --all          # Clear ALL history across all projects
+
 # Provider management
 imgx providers          # List providers and capabilities
 imgx capabilities       # Detailed capabilities of current provider
@@ -328,11 +377,13 @@ Or create manually:
 
 Project config is shared via Git. Do not put API keys in `.imgxrc`.
 
+When `.imgxrc` is present, imgx-mcp treats that directory as the project root. History is saved to `<project-root>/.imgx/output-history.json` (project-scoped, not shared with other projects). Relative paths in `output` and `output_dir` are resolved against the project root instead of the MCP server's working directory.
+
 ### Settings resolution
 
 1. CLI flags (`--model`, `--output-dir`, etc.)
 2. Environment variables (`IMGX_MODEL`, `IMGX_OUTPUT_DIR`, etc.)
-3. Project config (`.imgxrc` in current directory)
+3. Project config (`.imgxrc` — searched from current directory upward)
 4. User config (`~/.config/imgx/config.json` or `%APPDATA%\imgx\config.json`)
 5. Provider defaults