For AI agents: the complete documentation index is available at https://viteval.dev/llms.txt, the full documentation bundle is available at https://viteval.dev/llms-full.txt, and this page is available as Markdown at https://viteval.dev/cli/ui.md.
V1 release candidate available.Migration guide →
GitHub

ui

Start the dashboard using the server and browser assets included in the installed package. No development server is required.

Usage

viteval ui [options]

Options

OptionDefaultDescription
--root <path>, -rCurrent directoryProject root containing .viteval
--port <number>, -p6274Preferred port between 1 and 65535. Falls back to an available port if occupied
--open, -ofalseOpen the dashboard in the browser
--debug, -dfalseEnable debug mode, also enabled by VITEVAL_DEBUG_MODE=true

Data source

The dashboard reads datasets and evaluation results from the selected root's .viteval directory. Select eval.results: ['json'] to save evaluation snapshots under .viteval/results.

Hosted provider results are not downloaded automatically. Keep a local report alongside hosted persistence if you want to inspect the same run here.

Dashboard, results, datasets, suites, and settings URLs support direct navigation and reloads. Stop the server with Ctrl+C.

Examples

viteval ui
viteval ui --root ./app
viteval ui --port 6274 --open

See inspect results for report configuration and the inspection workflow.