# Changelog

## Unreleased

- **Fix:** restyling an app no longer changes pinned shortcuts that only launch through it with arguments, such as Steam games (which run `steam.exe steam://rungameid/…`) or browser profile shortcuts. Found on screen: restyling Steam also changed a pinned Steam game.
- `iconwright report` prints system details and a self-test as Markdown for test reports, without app names, paths or the user name.
- `iconwright mcp` starts the MCP server, and the package is ready for npx as `iconwright` (not published yet).
- Screenshots explain a locked or sleeping screen instead of failing with "The handle is invalid".
- Docs: test prompts for macOS, Linux and Windows with the stock taskbar; issue and pull request templates; what doesn't work while the screen is locked.

## 0.2.0 (2026-10-29)

A design release: iterate on icons cheaply, with your agent or by hand, and see them in place before using them.

**Design**

- `design_icons`: compare artwork (rows) and styles (columns) in one small grid; pick a cell like "B2".
- `search_icons` returns a numbered contact sheet, icon licenses, paging, set filters and a `palette` filter (single-color or multicolor sets).
- `preview_icon`: mockups on a Windows taskbar, Start menu, desktop and File Explorer, a browser tab, the macOS Dock, iOS and Android, plus true pixel sizes. On Windows, your own pinned apps sit around the icon.
- Styles are one string everywhere: `color=white bg=#2d5ba6 shape=squircle shadow`. New: gradient backgrounds, the squircle shape and a soft shadow.
- `app:<App name>` uses an installed app's current icon as a source (Windows).
- Export to macOS `.icns`, a favicon and web-app set (with a maskable icon and manifest) and PNG sets. `.ico` files now include 20 and 40 px images for 125% and 250% scaling.
- The studio: a visual editor in the browser, online or local (`iconwright studio`, or the `open_studio` tool). Local studio can apply icons to apps.

**Windows**

- `taskbar_pins`: pin, unpin and reorder in one call and one Explorer restart, with a dry run.
- Changes from agents and the studio run one at a time, start to finish.

**For agents**

- 20 tools instead of 27, with a 25% smaller tool list. Tool definitions live in one table that also generates the docs.
- MCP prompts: design-icon, restyle-taskbar, tidy-desktop, undo-everything.
- A rewritten skill with a design guide, `llms.txt`, `llms-full.txt`, and every docs page as Markdown.

**Renamed or merged tools**: `list_apps` and `app_info` → `find_apps`; `app_set_icon` → `app_apply_icon` with `icon`; `taskbar_pin`, `taskbar_unpin` and `taskbar_reorder` → `taskbar_pins`; `app_restore_icons`, `desktop_restore_icons` and `restore_all_icons` → `restore_icons`; `desktop_icon_size`, `desktop_options` and `desktop_system_icons` → `desktop_settings`; `desktop_layout_save` and `desktop_layout_load` → `desktop_layout`; `desktop_move` takes a list; `make_sheet` → `design_icons`. Style options are now one `style` string.

**Fixes**: recoloring leaves SVG masks and clip paths alone and recolors gradient fills; artwork with an opaque background keeps it; gradients span the whole icon at any angle, as in CSS; edited source files are never served from a stale cache.

## 0.1.0 (2026-10-27)

First public version.

- Make `.ico` icons (256 to 16 px) from Iconify names, SVG, PNG, JPEG, WebP or existing `.ico` files, with recolor, backplate, padding and preview images. Works on Windows, macOS and Linux.
- Windows: change app icons on the taskbar, Start Menu and pinned shortcuts; pin, unpin and reorder taskbar apps; move, arrange, resize, re-icon, show and hide desktop icons; save and load desktop layouts.
- Undo: `restore <app>`, `restore --all`, `desktop restore`, and `restore-pins` (pin list backups taken before every change).
- Safety: pin-list writes refuse unfamiliar layouts, roll back on failure, and run one at a time. `doctor` checks a PC before use.
- Interfaces: CLI, MCP server (stdio), Claude Code plugin with a skill, and Codex via MCP.