miao-vision

Create a self-contained Miao Vision artifact when the user explicitly invokes $miao-vision and supplies an article URL or local Markdown/text for an infographic, or local Markdown/text and optional CSV, TSV, XLSX, or JSON data for an HTML/PDF report, single-page data poster, browser deck, or an optional data-story image/video that explains a verified conclusion. It can also use the optional local Review Viewer to monitor a generation run, inspect its evidence and artifact preview, compare versions, or export a selected version. Also validate a user-supplied Miao Vision report or deck spec. Do not trigger from isolated keywords such as chart, report, dashboard, slides, infographic, or PDF.

Miao Vision Plugin Installation

Current compatible plugin release: v0.10.4 (skill-v0.10.4), with @miao-vision/cli@0.9.4. Download the cross-host bundle from:

https://github.com/miaoshou-dev/miao-vision/releases/latest/download/miao-vision-plugin.zip

The cross-host plugin bundle is the recommended installation. It contains the same source skill for Codex, Claude Code, and OpenClaw:

Codex: see codex.md
Claude Code: see claude.md
OpenClaw: see openclaw.md
Pi: see pi.md

The standalone Skill ZIP remains a lightweight compatibility channel for one release cycle.

Miao Vision uses the global miao-viz on PATH. The bundled node scripts/check-miao-viz.mjs --print-path checks compatibility and returns its absolute path. A compatible CLI is accepted even when its version differs from the recommendation. If missing or incompatible, approve the bundled installer, which runs npm install -g @miao-vision/cli at the fixed recommended version. It does not use sudo or change shell configuration. Old binaries in ~/.miao-vision/bin remain untouched and are no longer selected automatically.

PNG/PDF export requires Playwright and matching Chromium. Run node scripts/setup-export.mjs --host cli to check without installing; after approval add --install. It reuses host dependencies first, then ~/.miao-vision/playwright, then workspace dependencies. Claude Code checks project and user .claude directories; other hosts may specify their actual root with --host-root. Downloads use the selected Playwright's own installer. Business-project dependencies are never modified. No API key is required.

All ordinary source-data workflows stay local. Optional data-story image/video generation requires Node.js 22+, ai-cli, AI_GATEWAY_API_KEY, remote upload confirmation, and separate Gateway fees. It sends only the displayed prompt and approved references; the original Node.js 20 workflows do not require it. PDF browser dependencies are optional and are not downloaded with the plugin. Remove the global CLI with npm uninstall -g @miao-vision/cli; plugin uninstall leaves it intact.

Try It

After installation, attach your file or link and ask your agent:

“Analyze this sales spreadsheet and create an HTML report with key metrics and charts.”
“Export this report as a printable A4 PDF.”
“Use this week’s new data to update last week’s report with the same metrics and layout.”