zigzag
Free, open-source embroidery software for Mac and Windows. Turn SVG artwork into machine embroidery, edit stitches visually, and create designs with AI agents via MCP.
Install / Use
claude mcp add simpsoka -- npx -y github:simpsoka/zigzagIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of zigzag
zigzag scores 83/100 on our quality scale, 2975th of 4,698 Development & Engineering skills we index.
Its MCP Server is 46 KB long, well organised into 19 sections with 10 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 858 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated yesterday, so zigzag is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-14. Automated pattern scan on 2026-11-14. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
zigzag compared with similar skills
All 4 of these similar skills score higher than zigzag; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| zigzag (this skill)by simpsoka | 83 | 858 | 1d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install zigzag?
- Run
claude mcp add simpsoka -- npx -y github:simpsoka/zigzag. The install tabs above show the steps for each supported agent. - Which AI agents does zigzag work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is zigzag safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is zigzag still maintained?
- The repository was last updated yesterday, so zigzag is actively maintained.
Skill content
View source on GitHubZigZag
ZigZag is a visual embroidery editor built in Rust for performance, with built-in MCP (Model Context Protocol) support so AI agents can create and edit designs alongside you. Turn SVG artwork into stitches, fine-tune it in the editor, and export PES, DST, EXP, JEF, or VP3 for broad compatibility with embroidery machines—or send designs directly to a Brother Skitch (PP1) over Bluetooth.
Draw in Illustrator, draw in ZigZag, or let an agent draw. The Rust engine
and zigzag command-line tool power the same workflow outside the editor.
See ZigZag in action
https://github.com/user-attachments/assets/94812f25-82f4-429f-85db-5e20c1d5e723
Stitching on a Brother Skitch (PP1)
<a href="https://github.com/simpsoka/zigzag/raw/refs/heads/main/packaging/media/skitch-pp1-demo.mp4"> <img src="packaging/media/skitch-pp1-demo.jpg" alt="Download the video of ZigZag stitching a design on a Brother Skitch PP1" width="320"> </a>Download the video (MP4, 1080p) · Original post on X.
Download for Mac
For Apple Silicon and Intel Macs, macOS 11 or later. Open the DMG, then drag ZigZag into Applications. The release is signed and notarized by Apple. No Rust installation is needed.
Or with Homebrew:
brew install --cask simpsoka/zigzag/zigzag
To update a Homebrew installation:
brew upgrade --cask --greedy simpsoka/zigzag/zigzag
Starting with version 0.1.3, ZigZag also offers an in-app updater: it tells you when there's a newer release and installs it when you say (ZigZag › Check for Updates…).
Download for Windows
Download ZigZag for Windows
— the ZigZag-<version>-x86_64-windows.zip asset on the latest release.
For 64-bit Windows 10 (version 1709 or later) and Windows 11. Unzip it and double-click ZigZag.exe. Windows SmartScreen warns on apps without a Microsoft-trusted signature the first time they run; click More info → Run anyway. No Rust installation is needed.
Download for Linux
Download ZigZag for Linux
— the ZigZag-<version>-x86_64-linux.tar.gz asset on the latest release.
For x86-64 Linux desktops with glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+),
X11 or Wayland, and OpenGL. Extract the archive and run ./zigzag-studio
inside the extracted folder. It also includes the zigzag CLI and
zigzag-mcp bridge; no Rust installation is needed. See the included
README.txt for runtime dependencies and Bluetooth setup.
Release notes and checksums · Changelog · Publishing a release
zigzag/
src/svg.rs SVG import (usvg): fill and stroke parts, transforms, text
src/document/ editable document; settings saved back into SVG ids,
layout edits as SVG transforms, lettering
src/params.rs stitch settings tokens + fabric presets
src/stitch/fill.rs tatami fill (scanline sections, staggered rows)
src/stitch/satin.rs satin columns: two rails, auto-satin, underlays, short stitches, lean
src/stitch/columns.rs shapes that branch or have holes, cut into satin columns
src/stitch/stroke.rs running / triple-run stitch
src/boolean.rs polygon booleans and offsets (i_overlay)
src/design.rs planner: overlap removal, cap order, routing, trims
src/route.rs travel out of sight: a way through fills and under what covers
src/checks.rs digitizing checks (sizes, widths, lettering, hoop)
src/machine/profile.rs machine profiles: hoops and file format, built in (profiles.json) or your own
src/formats/ PES (+PEC), DST, EXP, JEF, VP3, Skitch PEN writers;
PES/PEC/DST/EXP/JEF readers; preview; worksheet
src/machine/ Skitch Bluetooth protocol (+ btleplug client, `ble` feature)
src/studio/ editor (egui on OpenGL via glow) + MCP server (`gui` feature)
src/mcp_bridge.rs stdio ↔ HTTP bridge for MCP clients that launch a command
Build
cargo build --release # CLI + MCP bridge, no system deps
cargo build --release --features gui,ble # + the studio editor and Skitch upload
Linux needs the usual X11/Wayland and OpenGL dev libraries for gui. libdbus
is vendored for ble.
Stitch types
| Type | What it does | Works on |
|---|---|---|
| Fill (tatami) | Staggered rows, any angle, with underlay (edge walk + rows) and pull compensation | Filled shapes |
| Satin | Zigzag column between two rails, with center/contour/zigzag underlay, pull compensation and short stitches on tight curves; plain, S-stitch or zig-zag top stitching; stitches square across or leaning (lean=8); several threads across the column (multicolor satin) | Strokes (any width); Ink/Stitch-style two-rail paths with rungs; filled shapes: rings use inner/outer outline, bars and crescents split at their tips, letters and other shapes that branch or have a counter are cut into columns where the branches part (a P into its stem and bowl, a T into bar and stem), or border follows the outline |
| Run | Running stitch, single or triple (bean) | Strokes and outlines |
| Contour | Rows that follow the outline inward, or one spiral out from the center (Ink/Stitch's circular fill) | Filled shapes |
| Blanket | E-stitch: a line with prongs into the shape | Edges, appliqué |
| Appliqué | Placement line → stop → tack-down → stop → satin cover | Filled shapes |
| Manual | Every path point is a needle point | Imported machine files, pen tool |
| Meander | One wandering line through the shape, quilting style: light and soft | Filled shapes |
| Ripple | Open running-stitch rows following the outline, or one spiral | Filled shapes |
| Cross-stitch | A grid of X's, sewn as rows of half-crosses out and back | Filled shapes |
| Tartan | Woven stripes in several threads (a mirrored sett you edit in the panel), each thread its own color block | Filled shapes |
Satins wider than 7 mm are auto-split (shorter, staggered stitches) and use auto spacing (narrow columns more open, wide ones denser).
Planner features:
- Remove overlaps: fill hidden under later objects isn't sewn (keeps 0.5 mm of overlap).
- Cap order: center-out, bottom-up, grouped by color, still respecting layering.
- Routing: travel stitches stay out of sight: straight across where a straight line stays inside the fill, otherwise round the inside of its outline (Ink/Stitch's underpath), otherwise any way through the fill (round its holes, through its necks), under a satin that's about to be sewn, or under whatever is sewn later on top. An object's last piece is sewn toward the end the next object can be reached from. So satin lettering sewn stroke by stroke needs cuts only between letters when each stroke is followed by one that covers the way to it (a T's stem before its bar; an E's bars before its stem). A fill in separate parts is sewn part by part, each part's underlay and top together. So a fill with cut-outs, or a dither in scattered blocks under another color, is sewn with few or no cuts. Trims only where none of that works (up to 50 mm of travel).
- Sewing control per object: a start and an end point (where the thread comes in and leaves, so the next object is close), trim after, stop after (to lay foam or trim appliqué). What's left to cut is the document's Connect bar: drag it to sew across gaps up to N mm (between objects, or the parts of one) with running stitches instead of cuts. Those stitches show, so the panel counts the cuts saved as you drag and the canvas lights up what would be sewn.
- Fabric presets: standard, thin cotton cap, structured cap, knit.
- Checks: narrow fills, wide/narrow satins, small lettering, tiny gaps, fully covered objects, hoop fit.
- Group colors: reorder to cut thread changes without breaking layering.
Mac app
On a Mac with Rust and the Xcode command line tools
(xcode-select --install):
packaging/macos/make-app.sh --install # builds ZigZag.app and copies it to /Applications
packaging/macos/make-app.sh --dmg # also makes dist/ZigZag-<version>.dmg to share
packaging/macos/make-app.sh --universal # one app for Apple Silicon and Intel Macs
packaging/macos/make-app.sh --release # the DMG to publish: universal, signed, notarized
--release signs with your Developer ID and has Apple notarize the app and
the DMG, so it opens on any Mac without warnings. Once, beforehand: add a
Developer ID Application certificate (Xcode › Settings › Accounts › Manage
Certificates › +), make an app-specific password at account.apple.com, and
save the notarization credentials in your keychain:
xcrun notarytool store-credentials zigzag-notary --apple-id YOUR_APPLE_ID --team-id YOUR_TEAM_ID
The app bundles the studio, the zigzag command-line tool and the MCP
bridge. To use the command line from anywhere:
ln -s /Applications/ZigZag.app/Contents/MacOS/zigzag /usr/local/bin/zigzag.
For Claude Desktop, point the MCP config at
/Applications/ZigZag.app/Contents/MacOS/zigzag-mcp.
Without --release the app is signed ad hoc, not notarized. It opens normally on the Mac that
built it. On another Mac, macOS blocks it the first time: open System
Settings › Privacy & Security and click Open Anyway (on macOS 14 and earlier,
right-click the app and choose Open instead). macOS asks for Bluetooth
permission the first time you send to the Skitch.
Studio
The approved embroidered icons live in packaging/macos/AppIcon.png (light)
and packaging/macos/AppIcon-dark.png (dark). The Mac build regenerates both
multi-resolution .icns files; run bash packaging/macos/make-icons.sh to
regenerate them separately. Finder and the unopened app use the light icon.
While the studio is running, its Dock icon follows the app's light/dark theme,
including the ZIGZAG_THEME=light|dark override.

zigzag-studio [design.svg|logo.png] [--mcp-port 7878 | --no-mcp | --mcp-stdio]
Laid out like Illustrator, styled like a Mac app:
- Tools down the left edge: Select (V), Direct Selection (A), Hand (H), Pen (P): click for corners, drag for curves (Option breaks the handles, Shift keeps 45°, Space moves the point being placed); while drawing, Option lends it the Anchor Point tool (drag a segment to bend it, a handle to move it alone, click a smooth point for a corner) and ⌘ lends Direct Selection (drag a point or handle, then keep drawing), and on a selected path Option-drag bends a segment too. Illustrator's Pen group is behind it: Add Anchor Point (+) clicks a point onto an outline without changing its shape, Delete Anchor Point (-) clicks one out (Option swaps the two while held), and Anchor Point (Shift+C) converts points between smooth and corner and drags one handle alone. Press and hold the Pen (or right-click it) for the group's flyout, Option-click it to step through the group, or tear the group off into a toolbar of its own with the strip at the flyout's edge; the Shape tools work the same way. Brush (B), with VectorCraft's path clean-up tools in its group: Smooth (drag along a path to take the wobble out: fewer points, smoother curves; Smoothness in the bar above), Path Eraser (drag across a path to cut that part away) and Join (scrub between two open ends to join them, or an open path's two end
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
