diagramlisted

# vd:diagram Turn natural-language descriptions into reviewable diagram images and version-controlled diagram artifacts. Two render paths: - **PNG** (default): generates the image. Default image provider is **codex** (`gpt-image-2` via your ChatGPT subscription - cost-optimized, no per-image API spend), with automatic fallback to OpenRouter `gpt-5.4-image-2` when codex is unavailable and an OpenRouter key is set. Force the API path with `--provider openrouter`. With `--provider codex` and an explicit `--type`, no `OPEN_ROUTER_KEY` / `OPENROUTER_API_KEY` is required. - **SVG** (`--format svg`): the LLM emits the SVG markup directly. Cheaper, crisper labels, hand-editable. Use `--versioned` only when the diagram source, variants, and manifest are themselves review artifacts for an ADR/spec/PR. It writes a stable folder under `docs/diagrams/<slug>/` with: - `diagram.spec.yaml` - reviewable source intent (type, preset, engine, description, latest variant) - `manifest.json` - deterministic metadata for automation - `v1.svg`, `v2.svg`, ... or `v1.png`, `v2.png`, ... - rendered variants For a diagram that merely illustrates a docs page, keep the generation session in the injected `Visuals:` path, copy the final rendered image into the docs' local assets folder (for example `docs/design/assets/<slug>.svg`), and link that one asset from Markdown. Do not create `docs/diagrams/` just because a docs page references an image. ## Quick Start ```bash # Resolve the Python interpreter: s