For AI agents: the documentation index is at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
CLI
The published iconsmith package is a local compiler: prepare, check, render, draw, lint.
The published npm package is the compiler CLI, not the hosted model. Drawing through iconsmith-1 is the HTTP API or the public skill. These commands never call a model.
Requires Node.js 24.11 or newer.
Prefix commands with npx --yes iconsmith@0.1.0. Use --help for options.
| Command | Purpose |
|---|---|
prepare | Save a request, pinned revision and related drawings |
check | Compile a candidate, verify exact replay and create preview images |
render | Preview an existing SVG at native size and on light/dark backgrounds |
draw | Compile an .icon drawing to SVG |
lint | Check SVG files or piped SVG against the house spec |
schema | Read command arguments, options, defaults and enums as JSON |
A selected result is independently reviewed development work. The compiler still reports craftApproved: false: structural checks, not visual approval.
Published with Edda