v0.4.0-beta.2

[0.4.0-beta.2] - 2026-10-31

A prerelease for testing: npm dist-tag next, and a GitHub pre-release with open-design-0.4.0-beta.2.mcpb and, new, open-design-chatgpt-plugin-0.4.0-beta.2.zip. The Claude plugin stays on 0.3.0.

ChatGPT desktop: run npx @feimacode/open-design-agent-kit@next install chatgpt, or install chatgpt --from the zip from this release.

• ChatGPT desktop. Each release now carries open-design-chatgpt-plugin-<version>.zip, a ChatGPT "Desktop only" plugin with the same skills as Codex and the server bundled in. npx @feimacode/open-design-agent-kit install chatgpt puts it in ChatGPT's personal plugin list (uninstall chatgpt removes it); it runs in the Work and Codex tabs and saves designs in Documents/Open Design. ChatGPT desktop
• Hosted server (preview). npx @feimacode/open-design-agent-kit-mcp --http serves Open Design as a remote MCP server over streamable HTTP, for ChatGPT web and Claude web connectors: a shared access token, one folder per session, tools that need your own computer hidden, per-session limits, and signed download links for exports. deploy/Dockerfile builds a container with Chromium. There is no public endpoint yet. Hosted server
• Inline preview in ChatGPT. The preview view asks ChatGPT for fullscreen through its own API when the standard request isn't available, and the render tools carry ChatGPT's short status lines while they run. scripts/probe-mcp-apps-host/ records what a host supports.
• Works with Impeccable. Briefs include a short "Product context" from the project's PRODUCT.md, and note a project DESIGN.md when no design system is active. set_active_design_system takes writeProjectDesignMd to save the design system as the project's DESIGN.md (never overwriting one), and after porting to app code the agent suggests /impeccable polish when Impeccable is installed. Works with Impeccable
• The inline preview doesn't ask Claude to show the design again after "Ask Claude to apply" or "Fix this piece", since the shown design already updates in place.
• Why the default design folder wasn't used. The desktop extension logs its folder on start, and the "no folder" message says why the Default design folder setting was skipped.

What's Changed

• Say why the extension's default design folder wasn't used by @ivenxu in #77
• Inline preview: stop asking Claude to show the design again by @ivenxu in #78
• Apply the ChatGPT changes: desktop plugin, MCP Apps compat, Impeccable interop, hosted server phase 1 by @ivenxu in #74
• Release 0.4.0-beta.2: first ChatGPT desktop plugin zip by @ivenxu in #79

Full Changelog: v0.4.0-beta.1...v0.4.0-beta.2

v0.4.0-beta.1

[0.4.0-beta.1] - 2026-10-31

A prerelease for testing: npm dist-tag next, a GitHub pre-release with open-design-0.4.0-beta.1.mcpb. The Claude plugin stays on 0.3.0.

Claude Desktop extension: install open-design-0.4.0-beta.1.mcpb from this release to try it.

• The inline preview follows edits. In Claude Desktop Chat and Cowork, a design shown in the conversation updates in place after each round, so Claude shows it once. It waits while you write a comment, checks less often when idle and not while hidden. Inline preview
• The live preview in the Code tab's Browser pane, set up for you. Ask Claude to show the live preview and it adds an open-design-preview entry to .claude/launch.json (new tool set_up_open_design_browser_pane) and starts it. Each project gets its own port (5317–5416), the entry uses the npx beside your Node, and the pane opens the newest design (preview --root-latest). Claude Desktop
• Tool annotations. Every MCP tool says whether it only reads, writes in the workspace, or reaches another service (readOnlyHint, destructiveHint, openWorldHint).
• Links to the public gallery, behind a switch that stays off until the gallery goes public.
• Claude plugin 0.3.2: on Windows, the plugin's MCP server starts again when Node.js is installed under a path with spaces, such as the default C:\Program Files\nodejs (#66, thanks @mertol84).
• Claude plugin 0.3.1: each per-template skill's folder is now named like the skill (skills/od-prototype-card-twitter/), as the Agent Skills spec asks, so the Claude plugin directory can list them. Slash commands don't change.
• Add a Pinterest Pin export preset at 1000×1500 px with a 20 MB upload budget.

What's Changed

• Pin the Claude plugin to MCP server 0.3.0 by @ivenxu in #36
• Propose building a component library from a reviewed design (openspec) by @ivenxu in #37
• Add prepare_open_design_component_library: a component set from a reviewed design by @ivenxu in #38
• openspec: propose eight UI/UX quality changes (taste, a11y states, critic, questions, ask view, variety, evals, microcopy) by @ivenxu in #39
• Add states and microcopy craft by @ivenxu in #40
• Add output quality evals (briefs, runner, scorer) by @ivenxu in #41
• Add show_open_design_questions: tappable questions in the preview MCP App by @ivenxu in #42
• Ask a few structured questions and vary designs from recent ones by @ivenxu in #43
• Add design critic (openspec add-design-critic) by @ivenxu in #44
• Add taste and state accessibility checks to check_open_design_artifact by @ivenxu in #45
• Add contributing guide, issue and discussion templates by @ivenxu in #46
• docs: update bundled content counts by @Aaqibhafeezkhan in #58
• Feat/issue 48 pinterest pin format by @Aaqibhafeezkhan in #59
• docs: add a Simplified Chinese README by @hungb2408994-ctu in #61
• docs: add Japanese README by @eltociear in #62
• fix(claude-plugin): name each skill folder like its skill by @ivenxu in #63
• Add a hub-and-spoke gallery pilot for GitHub Pages by @ivenxu in #64
• Gallery: add a Claude Design view and pin thumbnail sizes by @ivenxu in #65
• Gallery: add gallery.json for agents and hash filters on the hubs by @ivenxu in #67
• fix(claude-plugin): start node without a shell on Windows by @ivenxu in #68
• OpenSpec: propose link-public-gallery by @ivenxu in #69
• Link the public gallery from the kit, behind a live switch by @ivenxu in #70
• OpenSpec: propose inline-preview-in-place and code-tab-browser-pane by @ivenxu in #71
• Inline preview follows edits; Browser pane setup in the Code tab by @ivenxu in #72
• OpenSpec: propose ChatGPT support (desktop plugin, MCP Apps compat, remote server) and Impeccable interop by @ivenxu in #73
• Release 0.4.0-beta.1 by @ivenxu in #75
• Fix release lint: resync the CLI's skill mirror by @ivenxu in #76

New Contributors

• @Aaqibhafeezkhan made their first contribution in #58
• @hungb2408994-ctu made their first contribution in #61
• @eltociear made their first contribution in #62

Full Changelog: v0.3.0...v0.4.0-beta.1

v0.3.0

[0.3.0] - 2026-10-24

Claude Desktop extension: install open-design-0.3.0.mcpb from this release to update it.

Open Design now works for people who never open a terminal: a Claude Desktop extension with nothing else to install, designs in a folder you can see, a plain welcome and plain replies. It also adds design systems from a website, recommendations when you haven't picked one, and cards, small print and shop images you can sell.

• Fewer false alarms from check_open_design_artifact. Text in a scrolling block (a pre with overflow-x: auto) inside a rounded overflow: hidden box is no longer reported as clipped; ©, ®, ™ and arrows are no longer reported as emoji; and a contrast ratio just under the bar now reads 4.49:1, not 4.5:1.
• Claude Desktop extension. Each release now carries open-design-<version>.mcpb: the MCP server for Claude Desktop on its own Node, with no Node.js install, no npx and no download on first start, a settings form for the Figma token (kept in the system keychain) and a default design folder. With the plugin installed too, Claude sees one set of tools. Claude Desktop
• Chat without a folder. With the extension, a Claude Desktop chat with no folder makes real designs: use_open_design_managed_workspace opens a folder for each design in ~/Documents/Open Design/, and write_open_design_file saves the files Claude writes there. With the plugin alone, Claude says what's missing and can make a single page as a Claude artifact.
• init pins the server. The .mcp.json, .codex/config.toml and .claude/launch.json entries now name the CLI's own version, so a project's server matches its skills. Re-run npx @feimacode/open-design-agent-kit@latest init to upgrade both.
• Design system from a website. /open-design-design-system-from-url (and Open Design: Design System from Website in VS Code) measures a rendered site in your installed browser: the colours of its background, cards, text and main button (with its hover and pressed states), the fonts it loaded, its type scale, radii, spacing and motion. It writes DESIGN.md and tokens.css from the same measurements, then shows the site beside a sample page in the new tokens before saving. New tool: extract_open_design_design_system. Design systems
• Built-in design systems describe one look. In most of the template design systems, DESIGN.md and tokens.css named different colours and fonts, so briefs and Claude Design exports mixed two brands. Each one now has a recorded choice of which side is right, and the other side is corrected to match. Designs made in these systems will look different, because their tokens changed: agentic, application, artistic, bento, bold, cafe, claymorphism, clean, contemporary, corporate, cosmic, creative, dashboard, dithered, dramatic, elegant, energetic, enterprise, expressive, fantasy, flat, friendly, futuristic, glassmorphism, gradient, lingo, minimal, modern, neon, neumorphism, pacman, paper, perspective, professional, refined, retro, simple, skeumorphism, spacious, tetris, vibrant, vintage. Content sync
• Every built-in design system, ready for Claude Design. claude-design-systems/ holds all 198 in Claude Design's Design System format: hover and tint shades computed to real colours, a brand-book README, and a cover drawn from each system's own colours and shapes. In Claude's Add design system, give this repository and a system's folder (for example claude-design-systems/kami), or upload the folder. scripts/claude-design-system.ts export now writes your own systems in the same format and checks them. Design systems
• A welcome for first-time users. In a new Chat with nowhere to save yet, Claude says so in plain words, offers the two ways on (connect a folder, or install the extension), then asks one question, "What's it for?", with goals to pick from (promote an event, run a shop, get hired, show an idea). list_open_design_skills takes a goal and lists the goals with surface: "list". Your first design
• Designs in a folder you can see. In Claude Desktop, designs go in a visible Open Design/ folder inside the connected folder, or in ~/Documents/Open Design/<name>/ with no folder. PNG, JPEG, PDF and PowerPoint exports sit beside the design with plain names (seed-swap-flyer-A4.pdf) and never overwrite a file you made. Folders that already hold designs under .open-design/, and designs an earlier release made in ~/Open Design/, keep working where they are; OPEN_DESIGN_OUTPUT_DIR keeps the classic layout. Settings
• Plain replies. Every skill and prompt shares one voice: everyday words instead of jargon, no tool names or internal files, print terms explained once, files described the way you would find them, and one line on what to do next.
• Canva uploads from the server. publish_open_design_artifact_to_canva takes filePath and uploadUrl and sends the export to Canva's upload URL itself, so Claude Desktop Chat no longer needs a terminal for it. Only https canva.com URLs and files in the design's exports/ folder are accepted.
• Full paths when attaching files. Claude gives a file's full path when it attaches or shows a design with its own tools, so Claude Desktop can find it.
• Server: OPEN_DESIGN_DEFAULT_WORKSPACE and OPEN_DESIGN_MANAGED_ROOT; the server reports its real version.
• Browsing works before a folder is set. In Claude Desktop, list_open_design_skills, list_open_design_design_systems and the example and design-system pickers no longer refuse until Claude names a folder, since they only read the bundled catalog. list_open_design_skills with more than 40 matches now returns pages of 100 compact entries (id, name, a one-line summary, mode, source) with counts by mode, and takes an offset for the next page, so no listing overflows Claude's limit for one tool result. Remixable entries now say remixable: true instead of naming the bundled example.html path, which agents in Claude Desktop went looking for with a whole-disk find.
• Design system recommendations. Not sure which design system to use? When nothing is active and you haven't named a look, the agent now recommends 3 to 5 from what you asked for, or asks up to three quick questions first, the same way in every agent. New tool recommend_open_design_design_systems; list_open_design_design_systems now matches every word of a query ("warm fintech"). Design systems
• Cards and small print. New formats for game cards with rounded corners (trading-card, tarot-card, mini-card), small print (a5, a6, a7, postcard-4x6, business-card, business-card-us) and shop images (shop-product, shop-banner, shop-collection). The check warns when text sits in a corner the printer cuts round. Posters and print
• Cards for a print house. Print images now come out at 300 dpi with the bleed included and the dpi written into the file (dpi changes it). printHouse writes each face at a printer's exact upload size, starting with Board Games Maker; list_open_design_print_houses lists them. A card back (data-od-side="back") exports as -front and -back files, and a print PDF puts each back after its front. CLI: --dpi, --print-house. Send cards to a print house
• Sell what you make. Two new recipes: shop-pack (product images, a store banner, a parcel card and launch posts from your product list and photos) and card-set (fronts, a back and a proof sheet from your card list and art). Cost, supplier and note columns never appear on a design. New surfaces Online shop and Game cards, and goals Sell online and Make cards to print and sell. Sell what you make
• Into your shop. publish_open_design_artifact_to_shop puts the designs in Shopify through its connector, showing the matches first and creating new products only as drafts, or writes a folder ready to upload (images named by product, copy.md, and a Shopify products.csv) for Shopify, Big Cartel or Etsy. Put your designs in your shop

What's Changed

• Served preview (experimental) + preview bridge for Comment, Edit and Figma by @ivenxu in #1
• Feat/browser preview by @ivenxu in #2
• feat: run the Claude plugin in Claude Desktop chats with a folder by @ivenxu in #3
• fix: move the plugin's MCP launcher out of bin/ so claude.ai can sync it by @ivenxu in https://github.com/feimacode/open-des...

v0.3.0-beta.4

No curated changelog entry for 0.3.0-beta.4 — see commits below.

What's Changed

• Add one-off design system copy to and from Claude Design (prototype) by @ivenxu in #16
• openspec: design system from a URL, and reconciling DESIGN.md with tokens.css by @ivenxu in #20
• Recommend a design system from the conversation or a few questions by @ivenxu in #19
• Reconcile bundled design systems; add design system from a website by @ivenxu in #21
• Fix design-system-from-url issues found on dating.com by @ivenxu in #22
• Propose Claude-ready design system builds (openspec) by @ivenxu in #23
• Build every bundled design system for Claude Design by @ivenxu in #24
• feat(desktop-extension): declare Linux in the .mcpb manifest by @ivenxu in #25
• Let catalog tools run before a folder is set; compact the full skill list by @ivenxu in #26
• Recognise Claude Desktop's real MCP client name by @ivenxu in #27

Full Changelog: v0.3.0-beta.3...v0.3.0-beta.4

v0.3.0-beta.3

No curated changelog entry for 0.3.0-beta.3 — see commits below.

What's Changed

• Served preview (experimental) + preview bridge for Comment, Edit and Figma by @ivenxu in #1
• Feat/browser preview by @ivenxu in #2
• feat: run the Claude plugin in Claude Desktop chats with a folder by @ivenxu in #3
• fix: move the plugin's MCP launcher out of bin/ so claude.ai can sync it by @ivenxu in #4
• docs(openspec): propose Claude Desktop support changes by @ivenxu in #5
• Claude Desktop guide, Code-tab path line, launch.json preview entry by @ivenxu in #6
• feat: show designs inline in Claude Desktop Chat (MCP App preview) by @ivenxu in #7
• Preview: opt-in root redirect for Claude Desktop's launch.json by @ivenxu in #8
• Publish designs as private Claude artifacts, with artifact previews and embedded 3D assets by @ivenxu in #9
• OpenSpec proposals for six Claude Desktop follow-ups by @ivenxu in #10
• Claude Desktop connector setup text for integrations by @ivenxu in #11
• Add opt-in artifact sync and restore_open_design_artifact by @ivenxu in #12
• feat: example, design-system and campaign pickers in the inline preview by @ivenxu in #15
• Recurring design jobs: job file, start/finish tools, recipe and guide by @ivenxu in #13
• Claude Desktop extension (.mcpb) and Chat without a folder by @ivenxu in #14
• Beta releases: npm next tag, init pins its version by @ivenxu in #17
• fix(release): unblock the 0.3.0 release build by @ivenxu in #18

New Contributors

• @ivenxu made their first contribution in #1

Full Changelog: v0.2.0...v0.3.0-beta.3

v0.2.0

[0.2.0] - 2026-10-10

Open Design Agent Kit now covers the whole path from idea to delivery: explore directions before committing, build from your own documents, check how a design renders, export it in any format (including print, video and email), share a link, and hand it to Canva, Figma or a posting service through the connectors your agent already has. The MCP server goes from 11 tools to 23.

New ways to start

• /open-design-new and "New design" tiles. Pick what to make (prototype, mobile app, slides, wireframe, poster, social post, campaign, HTML email, diagram, color + type, 3D object and more); the agent asks only for what's missing and uses the right recipe. In VS Code, the Gallery Grid opens with one tile per kind. list_open_design_skills gains a surface argument. Generate a design
• Explore design directions. /open-design-explore builds 2–4 genuinely different directions side by side, with a comparison page and contact sheet; pick one and it becomes the full design. Style tiles (up to 6) compare color and type pairings and can become your design system. New tools: prepare_open_design_exploration, compare_open_design_exploration, choose_open_design_direction. Explore design directions
• Decks from your documents. read_open_design_source turns DOCX, PPTX, XLSX, PDF, Markdown, CSV and text into Markdown with extracted images. /open-design-deck-from-source agrees a storyline with you first, then builds the deck with every number traced to its source; get_open_design_artifact flags a deck whose sources changed. Turn a document into a deck

New kinds of design

• Posters and print. /open-design-poster makes one fluid design that reflows to any size, from A0 to an Instagram story. Print PDFs get bleed and optional crop marks; create_open_design_qr_code makes real, offline QR codes; adapt_open_design_artifact re-composes a fixed-size design for other shapes; and data exports one copy per spreadsheet row (name cards, certificates). Posters and print
• Campaigns. /open-design-campaign takes one master design to every channel size and language, checked, with a campaign sheet. Run a campaign
• HTML email. An email-campaign skill and an email export that renders properly in Gmail, Outlook and Apple Mail; VS Code can copy it ready to paste into your email tool. HTML email
• Diagrams of your code. The agent reads the repo first, then draws architecture, dependency, flow, ER, state and sequence diagrams with an automatic layout runtime (add_open_design_diagram_runtime). Diagrams
• 3D objects and product shots. A studio-lit three.js scene from a brief, a .glb model or an SVG logo, exported as a still, a transparent cut-out or a turntable video. 3D objects
• Engineering documents. RFC, ADR, postmortem, PR explainer and changelog-page skills grounded in git, plus competitive teardown, executive briefing memo, experiment readout, funnel and sketchnote-article templates ported from html-anything. /open-design-docs turns a folder of Markdown into designed pages and refreshes only what changed. Engineering documents

Check and export

• check_open_design_artifact renders a design and shows the agent what it looks like: screenshots plus preflight findings (overflow, safe area, minimum type size, contrast, image resolution, QR decoding, overlapping text, broken assets, WebGL), at desktop and mobile, per card or per slide, and at chosen moments of an animation (at).
• Animation export: MP4, WebM and GIF, frame-exact and identical on every run thanks to a virtual clock. Uses an installed ffmpeg (never downloaded). Export animations
• More export formats: standalone (one self-contained HTML file), site (a deploy-ready folder), email, and paste (HTML that keeps its look when pasted into WeChat, Notion or a newsletter tool). Paste into WeChat, Notion and newsletters
• Export options: canvas preset/presets for print and screen formats, transparent PNGs, shapeSheet and campaignSheet contact sheets, checkOnly, and spreadsheet-driven data exports.

Share and connect

• Share a link. publish_open_design_artifact and /open-design-publish package a design and walk the agent through publishing it to a temporary Netlify or Cloudflare link, or your own Netlify, Vercel, Cloudflare Pages or GitHub Pages. Published pages carry an optional, closeable "Made with Open Design" badge and link-preview metadata. Share and publish
• Integrations. list_open_design_integrations and /open-design-integrations show which trusted services (Canva, Figma, Notion, Google Drive, Slack, Buffer, Metricool, X) your agent is connected to and how to connect the rest, only with your consent. Connect other services
• Canva: publish_open_design_artifact_to_canva gets a design into Canva through your Canva connector, or as a file to import.
• Figma: push_open_design_artifact_to_figma pushes a design in as editable layers through Figma's own MCP server, and pull_open_design_figma_frame now uses that connection too; a token is only needed without it. Figma

VS Code

• Tweaks panel in the preview: live controls for a design's colors, type and spacing variables. Apply them to the file, save a variant, send them to chat, or write them into your custom design system's tokens.
• New toolbar: Export and Share menus, and for fluid posters a Shape picker with zoom, Check and Use as default.
• A banner shows page script errors with Ask the agent to fix.
• Integrations view in the Open Design sidebar, with Refresh Integrations and Show Integration Setup commands.
• Collections view lists explorations and their directions; Open Comparison in Browser opens an exploration's comparison page.
• New prompts: /open-design-new, /open-design-explore, /open-design-deck-from-source, /open-design-poster, /open-design-campaign, /open-design-docs, /open-design-publish, /open-design-integrations.
• New settings: openDesign.export.ffmpegPath and openDesign.share.badge.

Claude Code, Codex and MCP

• The same workflows ship as model-invocable skills for Claude Code (plugin and init) and Codex: open-design-new, -explore, -deck-from-source, -poster, -campaign, -docs, -publish and -integrations, plus matching MCP prompts.
• Claude Code plugin: the Figma token is now a plugin option stored in your keychain; the MCP server is pinned to an exact version and installed from the plugin's lockfile instead of npx; the plugin has an icon.
• MCP server: uses the client's MCP roots for the workspace when it reports them (VS Code does), and is listed in the MCP registry as io.github.feimacode/open-design.
• New environment variables: OPEN_DESIGN_FFMPEG_PATH and OPEN_DESIGN_SHARE_BADGE.

CLI

• New check command: preflight findings and optional screenshots, with --fail-on to gate CI. CLI reference
• export gains the new formats and --preset/--presets, --bleed, --crop-marks, --check, --data/--sheet/--name-field/--split, --fps/--duration/--loop, --transparent, --ffmpeg, --campaign-sheet, --shape-sheet, --target, --base-url and --badge.
• init writes the new workflow skills.

Fixes

• Preflight no longer reports text inside scroll containers as clipped.

Releasing

• npm packages are now built and smoke-tested (a real publish to a local registry, npx resolution, an MCP handshake and init) on every release tag, then published by a manual, confirmed workflow that also updates the MCP registry listing.

Full Changelog: v0.1.8...v0.2.0

v0.1.8

No curated changelog entry for 0.1.8 — see commits below.

Full Changelog: v0.1.7...v0.1.8

v0.1.7

No curated changelog entry for 0.1.7 — see commits below.

Full Changelog: v0.1.6...v0.1.7

v0.1.5

No curated changelog entry for 0.1.5 — see commits below.

Full Changelog: v0.1.4...v0.1.5

v0.1.4

No curated changelog entry for 0.1.4 — see commits below.

Full Changelog: v0.1.3...v0.1.4