CLI reference

Run every command from the project folder, or pass --dir <project>. Read commands print a compact table, 20 rows by default and up to 200 with --limit, or JSON with --json. This page is generated from the built CLI's help.

$ tavero --help
Usage: tavero [options] [command]

UI consistency auditor for React apps, built for AI coding agents

Options:
  -V, --version              output the version number
  --dir <projectDir>         project directory (default: ".")
  --out <dir>                tavero output directory (default <dir>/.tavero)
  --json                     machine-readable output (default: false)
  -h, --help                 display help for command

Commands:
  scan [options] [dir]       crawl the app and write an inventory to
                             .tavero/scans/<time>/
  findings [options]         list findings of the latest scan
  finding [options] <id>     one finding with its evidence
  login [options]            open a browser and log in by hand, or pass
                             --email/--password to log in headlessly; saves the
                             session for scans
  components [options]       list components of the latest scan
  component <idOrName>       details of one component
  show [options] <idOrName>  print crop image paths for a component
  context [options]          compact design-system context for an agent (read it
                             before writing new UI)
  report                     write a self-contained HTML report (report.html)
                             into the latest scan directory
  mcp [options]              run the MCP server on stdio for this project (tools
                             tavero_*), or print a client config
  ui [options]               open the local web panel: triage findings and set
                             decisions agents will see
  diff [from] [to]           compare two scans (default: previous vs latest)
  tokens [options]           list design tokens found in the app
  help [command]             display help for command

Usage: tavero scan [options] [dir]

crawl the app and write an inventory to .tavero/scans/<time>/

Arguments:
  dir                 project directory (overrides --dir)

Options:
  --url <url>         dev server url, e.g. http://localhost:5173
  --routes <list>     comma-separated routes, overrides discovery
  --viewports <list>  comma-separated viewport names (default:
                      "mobile,tablet,desktop")
  --crop <list>       always crop these component names
  --api-origin <url>  allow requests to this backend origin (default: any
                      localhost)
  --keep-raw          keep per-page raw JSON (default: false)
  --rules <list>      comma-separated rules to (re)compute:
                      buttons,cards,colors,scales
  -h, --help          display help for command

Usage: tavero findings [options]

list findings of the latest scan

Options:
  --rule <rule>     buttons|cards|colors|scales
  --severity <sev>  high|medium|info
  --decision <d>    none|fix|reopened (human decisions from tavero ui)
  --all             include findings a human marked accepted (default: false)
  --limit <n>       rows per page (default: "20")
  --page <n>        page number (default: "1")
  -h, --help        display help for command

Usage: tavero finding [options] <id>

one finding with its evidence

Options:
  --evidence <n>  evidence rows per page (default: "20")
  --page <n>      evidence page (default: "1")
  -h, --help      display help for command

Usage: tavero login [options]

open a browser and log in by hand, or pass --email/--password to log in
headlessly; saves the session for scans

Options:
  --url <url>            login page url
  --email <email>        fill the email field and submit (headless)
  --password <password>  fill the password field and submit (headless)
  -h, --help             display help for command

Usage: tavero components [options]

list components of the latest scan

Options:
  --sort <by>   instances|name (default: "instances")
  --limit <n>   rows per page (default: "20")
  --page <n>    page number (default: "1")
  --query <q>   filter by name or file
  --unresolved  only components without a file (default: false)
  -h, --help    display help for command

Usage: tavero component [options] <idOrName>

details of one component

Options:
  -h, --help  display help for command

Usage: tavero show [options] <idOrName>

print crop image paths for a component

Options:
  --viewport <name>
  -h, --help         display help for command

Usage: tavero context [options]

compact design-system context for an agent (read it before writing new UI)

Options:
  --budget <tokens>  approximate token budget (default: "1500")
  -h, --help         display help for command

Usage: tavero report [options]

write a self-contained HTML report (report.html) into the latest scan directory

Options:
  -h, --help  display help for command

Usage: tavero mcp [options]

run the MCP server on stdio for this project (tools tavero_*), or print a client
config

Options:
  --print-config <client>  print the MCP config for one of: claude, cursor,
                           codex, gemini, antigravity, vscode, windsurf
  -h, --help               display help for command

Usage: tavero ui [options]

open the local web panel: triage findings and set decisions agents will see

Options:
  --port <n>      port on 127.0.0.1 (default: "4747")
  --open          open the browser (default: false)
  --export <dir>  write a static read-only copy of the panel for the latest scan
                  and exit
  -h, --help      display help for command

Usage: tavero diff [options] [from] [to]

compare two scans (default: previous vs latest)

Arguments:
  from        scan directory name under .tavero/scans
  to          scan directory name under .tavero/scans

Options:
  -h, --help  display help for command

Usage: tavero tokens [options]

list design tokens found in the app

Options:
  --kind <kind>  color|radius|spacing|font-size|font-weight|font-family|shadow|other
  --limit <n>    rows per page (default: "200")
  --page <n>     page number (default: "1")
  -h, --help     display help for command