> ## Documentation Index
> [HTML page](https://blode.co/iconsmith/docs/cli)
> [Documentation index](https://blode.co/iconsmith/docs/llms.txt)
> Use the index to discover all available pages before exploring further.

# 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](/api) or the [public skill](https://github.com/mblode/iconsmith). 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.