# Changelog All notable changes to this project are documented here. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [0.4.1] - 2026-05-06 0.4.1 is the startup hotfix for the broken 0.4.0 desktop packages. It restores packaged app startup on macOS and Windows, adds release validation so the failure mode is caught before publication, and includes the small UI, agent, documentation, i18n, and craft updates that landed while the hotfix was being verified. ### Added #### Web / UI - **Manual edit mode** for direct artifact edits. ([#620]) - **Cmd/Ctrl+P quick file switcher** for faster project navigation. ([#556]) - Resizable chat panel. ([#563]) #### Daemon and agents - Added model name to PI initial status and RPC abort on cancel. ([#618]) #### Craft and i18n - Craft `accessibility-baseline` module with opt-ins for dashboard, HR onboarding, and mobile onboarding. ([#587]) - Craft `rtl-and-bidi` module so artifacts handle Arabic, Hebrew, and Persian content more reliably. ([#595]) - Added i18n structure checks. ([#608]) ### Changed - Updated README first-PR links so `help-wanted` issues are surfaced alongside `good-first-issue`. ([#605]) ### Fixed #### Packaging - Fixed packaged desktop startup by building `@open-design/contracts` to `dist/*.mjs` + `.d.ts`, pointing its exports at compiled JavaScript, and building contracts before all packaged lanes pack workspace tarballs. ([#577]) - Added packaged runtime beta gating so release candidates install, start, inspect `/api/health`, collect logs, stop, and uninstall before promotion. ([#637]) #### Daemon and agents - Added the required stdio MCP server env field and recover from `-32602` on `session/set_model`. ([#627]) - Normalized ACP `mcpServers` to the stdio shape for Kimi/Hermes ACP. ([#612]) - Fixed agent CLI configuration and workspace focus mode. ([#604]) #### Web and desktop - Preserved error messages across conversation reloads. ([#623]) - Kept chat recoverable after conversation load failures. ([#637]) - Honored native macOS quit behavior in the packaged desktop shell. ([#637]) ### Documentation - Documented `OD_DATA_DIR` and migration from `.od/` to the Desktop app. ([#570]) - Added Chinese (Simplified) QUICKSTART. ([#578]) - Backported missing zh-TW README sections from the English README. ([#586]) - Synced and improved the Korean README. ([#619]) ### Internal - Refined release workflows, CI scope, e2e layout, and packaged runtime smoke coverage for beta validation. ([#637]) - Refreshed generated GitHub metrics. ([#592]) ## [0.4.0] - 2026-05-05 A multi-protocol leap: Open Design now ships as an MCP server, ships Critique Theater (Design Jury) Phase 4, gains live-reload + Tweaks mode + live artifacts in the preview pane, and adds five new agent / runtime adapters. 71 merged PRs from 40+ contributors over two days. Linux AppImage packaging landed in tooling, but the stable Linux artifact is deferred from 0.4.0 while containerized release packaging is hardened. ### Added #### MCP & agent integration - **`od mcp` — expose Open Design as a stdio MCP server.** Coding agents in other repos (Claude Code, Codex, Cursor, VS Code, Antigravity, Zed, Windsurf) can read files from local Open Design projects directly, including the project the user has open in the Open Design app right now. ([#399]) - **Link code folder support for agent context** — point agents at any local code folder alongside the design project. ([#455]) - Kilo CLI (ACP) agent adapter. ([#480]) - DeepSeek TUI agent adapter. ([#439]) #### Critique workflow - **Critique Theater Phase 4** — persistence, transcript, and orchestrator. The "Design Jury" multi-panelist scoring pipeline is now end-to-end. ([#481]) - Critique Theater foundation — shared contracts and streaming v1 parser (Phases 0–2). ([#387]) #### Preview pane - **Live-reload preview iframes** when project files change on disk. ([#409]) - **Tweaks mode for HTML previews** — element picker, pod selection, batched chat attachments. ([#513]) - URL-load HTML preview iframes by default (`?forceInline=1` opt-out). ([#384]) - **Live artifacts and Composio connector catalog.** ([#381]) #### Packaging & deployment - **Linux x64 AppImage tooling** in `tools-pack`; stable release artifact deferred from 0.4.0 while the containerized packaging lane is hardened. ([#369]) - Optimize packaged mac artifact size. ([#424]) #### Daemon - `OD_MEDIA_CONFIG_DIR` to relocate `media-config.json` (Nix store, immutable images, sandboxes). ([#411]) - Modernized multi-provider API proxy routing (Anthropic, OpenAI-compatible, Azure OpenAI, Google Gemini). ([#385]) - Seed daemon with pre-baked decks and web prototypes. ([#457]) #### Skills, design systems & prompt templates - **Atelier Zero** editorial collage landing-page design system. ([#366]) - `open-design-landing` rename, **kami skill bundle**, and landing OG assets. ([#428]) - Craft `animation-discipline` module + opt-ins on mobile-app, mobile-onboarding, gamified-app. ([#515]) - Craft `state-coverage` module + opt-ins on dashboard, mobile-app, kanban-board. ([#502]) #### Web / UI - Skills & design systems management page in Settings. ([#535]) #### Design Files - Batch ZIP download with multi-select. ([#405]) #### Internationalization - Complete **French** localization, README, and Quickstart. ([#326], [#397], [#434]) - **Ukrainian** UI localization. ([#395]) - **Russian** UI locale refresh + README + gallery metadata. ([#393], [#396]) - Brazilian Portuguese README translation. ([#460]) - Arabic README translation. ([#458]) ### Changed - Refactor `RUNTIME_DATA_DIR` resolution logic. ([#391]) - Update Codex sandbox invocation. ([#477]) ### Fixed #### Security - Bind daemon to localhost by default + origin validation. ([#365]) - Strip `ANTHROPIC_API_KEY` when spawning Claude Code. ([#400]) - Preserve `ANTHROPIC_API_KEY` when `ANTHROPIC_BASE_URL` is set. ([#514]) - Preserve `*_API_KEY` env vars for CLI agents in packaged builds. ([#404]) - Normalize daemon proxy origins. ([#392]) #### Daemon - Resolve daemon `package.json` from any compiled layout so the packaged app reports the correct version. ([#537]) - Correct Claude Code `--add-dir` capability detection. ([#440]) - Handle ACP `-32603` errors gracefully in `session/set_model`. ([#492]) - Expose skill resources via cwd-relative aliases. ([#435]) - Support nested paths in project file serve route. ([#401]) - Respect baseUrl path verbatim in OpenAI-compat proxy. ([#410]) #### Web UI - Prevent vertical scrollbar on artifact preview frame. ([#453]) - Prevent vertical scrollbar on `ws-tabs-bar`. ([#448]) - Language option button height truncation in Settings. ([#447]) - Aspect-ratio cards no longer overflow into siblings. ([#476]) - Add copy buttons for FileViewer code blocks. ([#471]) - Lowercase `todowrite` compatibility in ToolCard. ([#523]) - Cap `htmlPreviewSlideState` Map to prevent memory leak. ([#488]) - Isolate preview blob export paths. ([#429]) - Split execution-mode tabs and align active chip visuals. ([#418]) - Tighten entry-tab layout and design-system showcase color picker. ([#412]) - Lift coming-soon tip above sticky tabs and make it readable in dark theme. ([#382]) - Fix file tab wheel scrolling. ([#549]) #### Design Files - Clear selection on project switch. ([#465]) #### Agents - Copilot prompt processing with correct command format. ([#466]) - Codex Gemini CLI trust handling. ([#352]) #### Desktop - Show window on macOS dock activate. ([#270]) #### Packaging - Bundle prompt templates in packaged desktop resources. ([#417]) #### Landing page - Deploy with `npm wrangler`. ([#421]) ### Documentation - Discord invite badge in README. ([#504]) - Surface desktop downloads in README. ([#522]) - "Running the Project" section in README. ([#468]) - First-PR link points to /contribute page. ([#494]) - Defer README template-driven generation; capture #195 discussion. ([#403]) - Fix typo in zh-TW README. ([#548]) - Auto-generated metrics SVG and contributors wall refresh. ([#406], [#407], [#489], [#490]) ### Internal - Enforce test directory conventions. ([#496]) ## [0.3.0] - 2026-05-03 A fast follow-up to 0.2.0 focused on richer design workflows, packaged-agent reliability, export/deploy flows, and broader internationalization. 39 merged PRs from 25 contributors. ### Added #### Web / UI - Pet companion with Codex hatch-pet integration. ([#296]) - Brand design-system cards, thumbnails, and DESIGN.md side-by-side preview. ([#289]) - Per-tool renderer registry for generative UI. ([#282]) - Task completion sound and browser notification. ([#359]) #### Agents & daemon - Persist code-agent startup state. ([#255]) - Mistral Vibe CLI agent adapter. ([#354]) - Devin for Terminal support. ([#301]) - `OD_BIND_HOST` and `--host` for interface binding. ([#328]) #### Skills & exports - Taste-skill-derived web prototype and HTML PPT examples. ([#358]) - `pptx-html-fidelity-audit` skill wired into export prompts. ([#307]) - Broader PPTX fidelity script coverage beyond CJK. ([#308]) - Native desktop Save As dialog for `.pptx` downloads. ([#330]) - Export as Markdown from the share menu. ([#345]) #### Deployment - `/api/projects/:id/deploy/preflight` for pre-upload inspection. ([#320]) #### Internationalization - Arabic (`ar`) UI locale with RTL layout. ([#316]) - French (`fr`) UI locale. ([#376]) ### Fixed #### Agents, packaged runtime & Windows - Include `nvm` / `fnm` / `mise` agent CLI bins in packaged PATH. ([#364]) - Detect Codex and Gemini CLIs from user toolchain paths. ([#346]) - Upgrade `better-sqlite3` for Node 24 Windows prebuilt support. ([#357]) - Lead Copilot spawn with `-p -` so prompt-via-stdin is consumed. ([#351]) - Drop literal `-` argv from Codex spawn so prompts deliver via stdin pipe alone. ([#342]) - Wrap `cmd.exe` shim invocations to survive `/s /c` quote stripping. ([#339]) #### Web UI & files - Download as `.zip` now returns the actual project tree. ([#341]) - Keep Design Files view active after deleting a file. ([#329]) - Scroll workspace tabs in place instead of the window. ([#363]) - Treat inlined script content as literal in FileViewer. ([#343]) - Use response-order matching for bulk upload aggregation. ([#323]) - Serve `.jsx` / `.tsx` with JS-family MIME types so browser loaders accept them. ([#340]) - Fix macOS entry view drag region. ([#373]) #### Daemon & deployment - Increase project upload limit from 20MB to 200MB. ([#319]) - Bundle and rewrite assets referenced from inline `