agent-svgtools

Close the loop for agents authoring SVG from images.

A machine-first Rust CLI that helps agents reconstruct raster artwork as maintainable SVG by inspecting structure, rendering candidates, scoring visual agreement, and localizing differences.

Install with Homebrew (macOS, Linux)

brew install wyrd-company/tools/agent-svgtools

Read the docs Star on GitHub Other install methods

Agent reconstructing an owl with agent-svgtools

What it does

Scores a candidate SVG against a reference image with pixel match, SSIM and a combined score.
Ranks the regions that differ most, with bounding boxes in reference-image pixels.
Writes diff heatmaps, side-by-side panels, onion-skin blends and coordinate grids for vision models.
Audits SVG structure, palette, naming and vector safety, which scores alone cannot judge.
Prints TOON by default, with JSON, JSONL and pretty JSON on request.
Ships as a single static Rust binary with no C runtime dependencies.

Install

brew install wyrd-company/tools/agent-svgtools

cargo install agent-svgtools

From Git

cargo install --git https://github.com/wyrd-company/agent-svgtools.git

npx @wyrd-company/agent-svgtools --help

brew install wyrd-company/tools/agent-svgtools

cargo install agent-svgtools

From Git

cargo install --git https://github.com/wyrd-company/agent-svgtools.git

npx @wyrd-company/agent-svgtools --help

cargo install agent-svgtools

From Git

cargo install --git https://github.com/wyrd-company/agent-svgtools.git

npx @wyrd-company/agent-svgtools --help

Documentation

Releases

Latest 0.2.1 2026-07-22 Release notes on GitHub

Fixes

Publish the npm package under the @wyrd-company scope. Run it with npx @wyrd-company/agent-svgtools or install it with npm install --global @wyrd-company/agent-svgtools.

All releases