| cmd | Command whose stdout is visualized — any command emitting CSV/JSON tabular data or benchmark output (e.g., go test -bench=., cargo bench, cat data.csv). | — | "" |
| file | Path to an existing input file to visualize — benchmark output, CSV, or JSON (takes priority over cmd) | — | "" |
| bench-cmd | DEPRECATED: use 'cmd'. Command to run; honored only when 'cmd' is empty. | — | "" |
| bench-file | DEPRECATED: use 'file'. Existing input file; honored only when 'file' is empty. | — | "" |
| name | Dataset/benchmark name (-n flag) | — | Comparisons |
| title | Override the chart title when --col-axis produces one chart; independent of -n/--name, otherwise ignored (--title flag) | — | "" |
| description | Dataset/benchmark description (-d flag) | — | "" |
| tag | Tag/identifier for the dataset (-t flag) | — | "" |
| id | Dataset id for ?id= deep links (--id flag) | — | "" |
| group | Column/field names merged into the group name; forwarded as -g (accepts space- or comma-separated, e.g. 'name category region' or 'name,category/region'); parsed by -p/-r. Omit for csv/json to let vizb auto-group the most-unique categorical column onto the X axis | — | "" |
| group-pattern | Group pattern (-p flag) | — | x |
| group-regex | Group regex (-r flag) | — | "" |
| sort | DEPRECATED: use 'chart' input instead (e.g. chart: 'bar:sort=asc'). Sort order: asc or desc (-s flag) | — | "" |
| filter | Regex to include only matching rows (CSV/JSON: --group label) or benchmark names (-f flag) | — | "" |
| mem-unit | Memory unit: b, B, KB, MB, GB (-M flag) | — | B |
| time-unit | Time unit: ns, us, ms, s (-T flag) | — | ns |
| number-unit | Number unit: K, M, B, T (-N flag) | — | "" |
| select | csv/json only: select value columns; optional rename with {label} (e.g. 'price{Unit price},count') (--select flag) | — | "" |
| col-axis | csv/json + group: place numeric column names on this axis (n, x, y, or z) so all columns share one chart (--col-axis / -A flag). Requires group; target axis must not already be used by group-pattern. | — | "" |
| json-path | json only: select a nested array to chart via a jq-like dot path (e.g. '.data.results') (--json-path flag) | — | "" |
| stat | Enable stats panel (--stat flag). Empty = disabled; 'all' or 'true' = all categories; otherwise comma-separated from: counts, center, spread, extremes, shape, percentiles, confidence, correlations | — | "" |
| chart | Per-chart overrides (--chart flag, repeatable). One override per line: '<type>:<key>=<val>,...'. Keys: swap, sort, scale, labels, 3d-rotate, 3d. E.g. 'bar:scale=log' or 'pie:labels'. Blank lines and #-prefixed lines are ignored. | — | "" |
| charts | Chart types to generate (-c flag): bar, line, scatter, pie, heatmap, radar | — | "" |
| parser | Parser to use: csv, json, go, js:tinybench, js:vitest, rs:criterion, rs:divan (-P flag) | — | auto |
| show-labels | DEPRECATED: use 'chart' input instead (e.g. chart: 'pie:labels'). Show labels on charts (-l flag) | — | false |
| enable-3d | Bundle the 3D renderer for vizb ui (--3d flag, mainly useful with data-url when remote data shape is unknown at build time) | — | false |
| merge-files | Space-separated JSON files to merge | — | "" |
| merge-dir | Directory to scan for JSON files to merge | — | "" |
| tag-axis | Tag injection axis: n, x, y, or z (-A flag) | — | n |
| output-json | Path for JSON output file (leave empty to skip JSON generation) | — | "" |
| output-html | Path for HTML output file (leave empty to skip HTML generation) | — | "" |
| data-url | URL to fetch vizb JSON from at runtime (-U flag). Accepts full dataset payloads or a lazy [{id,name}] catalog with details at /dataset/<encoded-id>. | — | "" |
| vizb-binary | Path to a pre-built vizb binary on the runner. When set, skips release download/cache and installs this binary instead — useful for testing local builds or unreleased changes. | — | "" |