BunCover CLI

A cross-platform CLI tool for collecting and reporting test coverage data for Bun projects.

Installation

npm install -g @qualipsolutions/buncover

Commands

Login

Authenticate with your BunCover token:

buncover login --token <your_token>

Note: Your token should start with buncover_live_.

Start server

buncover serve --project-id <project_id>

Run your tests

Run tests with coverage reporting:

buncover run --project-id <project_id>

This command:

• Wraps bun test --coverage --coverage-reporter=text
• Uploads structured coverage data to BunCover API
• Optionally associates coverage with a project ID
• Saves project ID to config for future runs

Logout

Remove stored authentication token:

buncover logout

Configuration File

Create a buncover.json file in your project root:

{
  "log_level": "error", 
  "project_id": "your_id"
}

Configuration Options

• log_level (string): Controls verbosity of CLI output

  • error: Only show errors
  • warn: Show warnings and errors
  • info: Show general information, warnings, and errors
  • debug: Show debug information and all above levels
  • trace: Show detailed trace information and all above levels

• project_id (string): Optional project identifier

  • Can be set here or via --project-id flag
  • Takes precedence over command line flag if both are set
  • Used to group coverage reports for the same project

Requirements

• Node.js ≥ 14.0.0
• Bun runtime installed

Support

• Linux
• macOS
• Windows