Getting Started

Go

Pipe

go test -bench . | vizb -o output.html

From a saved file

go test -bench . > bench.txt
vizb bench.txt -o output.html

JSON pipeline

go test -bench . -json | vizb -o output.html

Save as JSON for later merging:

vizb bench.txt -o output.json
vizb output.json -o output.html

Note

To build from source, Go 1.24+ is required. Pre-built binaries from the installation page need no Go runtime.

Criterion

Pipe

cargo bench | vizb --parser rs:criterion -o output.html

From a saved file

cargo bench > bench.txt
vizb --parser rs:criterion bench.txt -o output.html

Divan

Pipe

cargo bench | vizb --parser rs:divan -o output.html

From a saved file

cargo bench > bench.txt
vizb --parser rs:divan bench.txt -o output.html

Vitest

Pipe

npx vitest bench | vizb --parser js:vitest -o output.html

From a saved file

npx vitest bench > bench.txt
vizb --parser js:vitest bench.txt -o output.html

Experimental

Benchmarking in Vitest is experimental and does not follow SemVer. The parser was tested against v4.1.7. Future Vitest versions may change output format and break parser compatibility.

Tinybench

Pipe

node bench.js | vizb --parser js:tinybench -o output.html

From a saved file

node bench.js > bench.txt
vizb --parser js:tinybench bench.txt -o output.html

Next Steps

Installation Go install, binary download, and PATH setup.

Parser Guide Choose the right parser for Go, Rust, or JavaScript benchmarks.

Commands All CLI flags and options.

Grouping Guide Multi-dimensional data with patterns and regex.