Run checks. Test what they catch.

Define project checks in a JSON harness. Test whether a guard or test suite detects a controlled change, and keep the evidence for review.

Invaris example output
$ go run ./cmd/invaris challenge --format text \
  examples/v1alpha2/invaris.json

detect-marker  guard=fixture-guard
baseline=PASS  observed=FAIL  proof=PROVEN
Decision: ACCEPT

The guard detected the deliberate change in the bundled fixture.

Quick start

Install the CLI

Use npm on Linux or macOS with Node.js 22.14+. On Windows, use WSL.

Check the CLI and preview a config
npx --yes --package=invaris-cli@latest invaris --version
npx --yes --package=invaris-cli@latest invaris init --dry-run

The version in the JSON is the harness format. CLI releases can share the same format.

Install for a project or download an archive

Run a guard challenge

With Go 1.27.4+ and a POSIX shell, run the bundled structured example from a checkout.

Run the structured example
git clone https://github.com/refactorroom/invaris.git
cd invaris
go run ./cmd/invaris challenge --format text examples/v1alpha2/invaris.json

PROVEN means the guard detected the expected finding on the changed file.

Choose a workflow