TUI
BLXBench interactive Terminal User Interface.
BLXBench features a modern Terminal User Interface (TUI) built with Ink and React. It provides a command-driven experience for configuring providers, selecting models, running benchmarks, and submitting reports.
Install the CLI globally as @bitslix/blxbench (see Installation); the binary name remains blxbench.
Starting the TUI
blxbenchScreens
Welcome Screen
The welcome screen shown when starting BLXBench:
Help & Commands
View available commands and shortcuts:
Account Management
Sign in to upload results to the leaderboard:
Configure Run
Select provider, models, and test filters:
Running Benchmark
Watch real-time progress during execution:
Navigation
| Key | Action |
|---|---|
Tab | Complete slash-command suggestions |
Enter | Run the current command |
Ctrl+C | Exit |
Common Commands
| Command | Action |
|---|---|
/help | Show all commands by category |
/show | Show the active configuration |
/provider | Pick a provider |
/models list | Fetch models from the current provider |
/models id,id | Set model ids directly |
/categories * or /categories speed,reasoning | Select test categories |
/levels easy,medium,hard | Select difficulty levels |
/limit N | Limit tests per category |
/ratelimit RPM-or-off | Throttle provider requests |
| `/report html | json |
| `/report submit on | off` |
/output-dir PATH | Change the report directory |
/auth login | Sign in with browser device login |
/auth whoami | Show the signed-in account |
/playwright install | Install Playwright Chromium |
/run | Start the benchmark |
Account Login
/auth login starts the blxbench device flow. blxbench opens the web app, you approve the displayed code in the browser, and blxbench stores local credentials in your user config directory.
Leaderboard submission requires a signed-in account with a pass tier that includes submission quota. Headless automation can instead use BLXBENCH_API_KEY with --submit.
Features
- Interactive model selection — Choose from available providers or type model ids directly
- Real-time progress — Watch benchmark execution
- Account integration — Sign in via browser device login and upload eligible reports
- Command help — Slash-command reference with completion