CLI

The Kensa CLI is a lightweight Go binary that serves HTML reports over HTTP — useful when your IDE doesn't have a built-in web server.

Setup

Copy the wrapper script from the Kensa repository into your project root:

• macOS / Linux — kensa (shell script)
• Windows — kensa.bat

The wrapper auto-downloads and keeps the binary up to date from GitHub releases. Commit it to your repository; the binary itself lives in .kensa/bin/ and can be gitignored.

Usage

Serve a directory directly

kensa --dir build/kensa-output

Serve a named folder from config

Add a .kensa-properties file to your project root:

testFolders:
  my-tests: build/kensa-output
port: 8080        # optional, default 8080

Then run:

kensa my-tests

Flags

Flag	Default	Description
--dir <path>	—	Directory to serve (overrides config)
--port <n>	8080	Port to listen on
--open	true	Auto-open browser on start

Building from source

cd cli
go build -o build/bin/kensa cmd/kensa/main.go