Skip to content

SupercovDocumentation

Documentation

Supercov documentation

Install Supercov, run a test suite, inspect coverage gaps, and compare runs.

Get started

Getting started

Install Supercov, run a test command, and inspect the first result.

Agent loop

Run a suite, query gaps, add a test, rerun, and compare results.

Reference

CLI reference

Commands, queries, flags, output formats, and exit codes.

Coverage model

Coverage obligations, MC/DC witnesses, and blocked verdicts.

Supported suites

Supported runners, attribution levels, builds, and remote execution.

Evidence and runs

Run storage, queries, comparisons, merging, and pruning.

Guarantees

Verification

Release checks for semantic equivalence and coverage accuracy.

Workspace isolation

Owned paths, cleanup, crash recovery, and source isolation.

Performance

Timing fields, storage costs, and overhead measurement.

Quick start

three commands

# 1. run the suite you already have
$ npx supercov -- npm test

# 2. find the next useful targets
$ npx supercov runs latest gaps --limit 10

# 3. prove the improvement
$ npx supercov diff <older-run> latest

Every query accepts --json. Collections accept --limit and --offset and print a copyable next-page command.