ZigZag, a Rust embroidery editor, adds MCP so AI agents can draw designs

ZigZag, a Rust embroidery editor, adds MCP so AI agents can draw designs

ZigZag is a visual embroidery editor written in Rust, shared on GitHub and on Hacker News as a Show HN post. The Hacker News title says the author's $300 embroidery machine needed a subscription, so they built their own app; the project README, which is the text this retelling rests on, does not mention that motivation.

The README describes the core workflow: turn SVG artwork into stitches, fine-tune it in the editor, then export PES, DST, EXP, JEF or VP3 files for broad compatibility with embroidery machines. Alternatively, send the design directly to a Brother Skitch (PP1) over Bluetooth. The headline feature is built-in MCP (Model Context Protocol) support, so AI agents can create and edit designs alongside the user. In the README's words: "Draw in Illustrator, draw in ZigZag, or let an agent draw." The Rust engine and a zigzag command-line tool run the same workflow outside the editor.

Distribution: for Macs (Apple Silicon and Intel, macOS 11 or later) there is a DMG that is signed and notarized by Apple, with no Rust installation needed. For Windows there is a zip on the latest release, for 64-bit Windows 10 (version 1709 or later) and Windows 11; unzip it and run ZigZag.exe. SmartScreen warns the first time because the app lacks a Microsoft-trusted signature, and the user clicks More info, then Run anyway. Building from source uses cargo: cargo build --release gives the CLI and MCP bridge with no system dependencies, while adding --features gui,ble brings in the studio editor and Skitch upload. On Linux the gui feature needs the usual X11/Wayland and OpenGL dev libraries; libdbus is vendored for Bluetooth. Mac packaging scripts can build an app, a DMG, a universal binary, or a release DMG that is signed and notarized with the builder's own Developer ID. Without the release flag, the app is signed ad hoc and not notarized, so another Mac blocks it on first launch until the user clicks Open Anyway in Privacy & Security.

MCP setup: the studio is launched as zigzag-studio [design.svg|logo.png] [--mcp-port 7878 | --no-mcp | --mcp-stdio]. The app bundles the studio, the zigzag command-line tool and an MCP bridge (a stdio to HTTP bridge for MCP clients that launch a command). For Claude Desktop, the README says to point the MCP config at /Applications/ZigZag.app/Contents/MacOS/zigzag-mcp.

The stitch engine and planner: the code covers tatami fill, satin columns (two rails, auto-satin, underlays, short stitches) and running or triple-run strokes. Satins wider than 7 mm are auto-split into shorter, staggered stitches and use auto spacing, with narrow columns more open and wide ones denser. The planner removes overlaps, so fill hidden under later objects is not sewn (it keeps 0.5 mm of overlap). It orders caps center-out, bottom-up and grouped by color while respecting layering. It routes travel stitches out of sight: straight across a fill where possible, round the inside of its outline, through the fill, or under whatever is sewn later on top. Trims are used only where none of that works, up to 50 mm of travel. Each object can have a start and end point, a trim after, or a stop after (for laying foam or trimming appliqué). A document-level Connect bar lets the user sew across gaps up to N mm with running stitches instead of cuts, and the panel counts the cuts saved as you drag. Fabric presets are standard, thin cotton cap, structured cap and knit. Built-in checks flag narrow fills, wide and narrow satins, small lettering, tiny gaps, fully covered objects and hoop fit. A group-colors option reorders objects to cut thread changes without breaking layering.

The editor is laid out like Illustrator. Tools include Select, Direct Selection, Hand, a Pen with an Illustrator-style group (add, delete and convert anchor points), a Brush with path clean-up tools (Smooth, Path Eraser, Join), shapes (rectangle, ellipse, line, polygon, star), Fill Angle, Measure and Text. Other features: smart guides, round corners, Pathfinder operations (Unite, Minus Front, Intersect, Exclude), Offset Path, Outline Stroke, Simplify and Clean Up, which removes stray points and objects under 1 mm by default. Image Trace opens a PNG, JPEG, WebP, GIF, BMP or TIFF and traces it into flat-color shapes; the user can choose the color count, remove a white background and snap colors to Brother, Janome or custom thread palettes. Flat logos trace exactly, while photos are posterized. On the command line, zigzag convert logo.png -o logo.pes does the same. The README excerpt available here is cut off partway through the editor feature list.

Key facts

  • ZigZag is a visual embroidery editor built in Rust that turns SVG artwork into stitches and exports PES, DST, EXP, JEF or VP3.
  • Built-in MCP support lets AI agents create and edit designs alongside the user; a zigzag command-line tool and MCP bridge run the same workflow outside the editor.
  • Designs can be sent directly to a Brother Skitch (PP1) over Bluetooth.
  • Mac releases (macOS 11 or later, Apple Silicon and Intel) are signed and notarized by Apple; Windows 10 (version 1709 or later) and 11 get a zip that triggers a SmartScreen warning on first run.
  • The planner auto-splits satins wider than 7 mm, keeps 0.5 mm of overlap when skipping hidden fill, and trims only where other routing fails, up to 50 mm of travel.

Why it matters

ZigZag is a visual embroidery editor that reads ordinary SVG, writes five common machine formats and talks to a Brother Skitch (PP1) over Bluetooth. The Hacker News title frames it as a reaction to a $300 machine that needed a subscription, though the README itself does not say so. The distinctive piece is MCP support: an AI agent can draw and edit stitch designs through the same editor the user works in.

Who it affects

Owners of a Brother Skitch (PP1) get direct Bluetooth upload. Anyone with a machine that reads PES, DST, EXP, JEF or VP3 files can export to it. Designers who work in Illustrator-style tools will find a familiar layout and shortcuts. People who want to drive embroidery design from an AI agent such as Claude Desktop can use the MCP bridge. Mac and Windows users get prebuilt downloads; Linux users build from source.

How to use it

On a Mac, open the DMG and drag ZigZag into Applications; no Rust installation is needed. On Windows, download the zip from the latest release, unzip it and double-click ZigZag.exe, then click More info and Run anyway at the SmartScreen prompt. To build from source, run cargo build --release for the CLI and MCP bridge, or add --features gui,ble for the editor and Skitch upload. To connect an agent, start zigzag-studio with --mcp-port 7878 (or use --mcp-stdio, or --no-mcp to disable it), or point Claude Desktop's MCP config at the bundled zigzag-mcp. To trace a logo from the command line, run zigzag convert logo.png -o logo.pes. The excerpt gives no price or license.

How solid is it

The only source is the project README, and the available text is truncated, so later sections are not covered. It does not mention the $300 machine or the subscription from the Hacker News title. It gives no author name, version number, release date or benchmarks, and no license or price. It does not say which machines beyond the Brother Skitch (PP1) were tested, or how much of the app was written with AI help. The Mac release is described as signed and notarized by Apple; the Windows build is not signed with a Microsoft-trusted signature.

Risks and caveats

The Windows build triggers a SmartScreen warning, and a Mac built without the release flag is only ad-hoc signed and gets blocked on other machines until the user approves it manually. Hardware testing is described only for the Brother Skitch (PP1); other machines are covered by file export, and the excerpt does not say how well those files work on them. The README gives no Linux prebuilt binary, only build instructions that need X11/Wayland and OpenGL dev libraries. Giving an AI agent control of an editor through MCP is a convenience that the README does not discuss further, and no limits or safeguards are described in the excerpt.

“Draw in Illustrator, draw in ZigZag, or let an agent draw.”

— ZigZag README