Skip to content
coverctl

Install coverctl

coverctl is a single self-contained binary. It runs locally — no SaaS account, no source upload. After install, run coverctl mcp doctor to validate setup.

Section titled “Recommended: prebuilt binary via Homebrew”
Terminal window
brew install klarlabs-studio/tap/coverctl

Works on macOS and Linux. Same binary runs the CLI and the MCP server (coverctl mcp serve) the agent calls.

Alternative: install from source with Go

Section titled “Alternative: install from source with Go”

If you already have Go 1.25+ on your machine, or you prefer source installs:

Terminal window
go install go.klarlabs.de/coverctl@latest

This installs the latest release to your $GOPATH/bin directory. Go is not required for coverctl itself if you use the Homebrew binary — only for Go project coverage.

Requirements

Section titled “Requirements”
  • Git (for diff-based coverage features)
  • For Go project coverage: Go 1.20+ in the project under test
  • For other languages: their native test runner (pytest, nyc/c8, cargo-llvm-cov, JaCoCo, etc.) — coverctl invokes it for you

Install a Specific Version

Section titled “Install a Specific Version”
Terminal window
go install go.klarlabs.de/coverctl@v1.17.0

Verify Installation

Section titled “Verify Installation”
Terminal window
coverctl version

You should see output like:

coverctl v1.13.0 (40be00f) built 2026-03-01

Shell Completions

Section titled “Shell Completions”

coverctl supports shell completions for bash, zsh, and fish.

Terminal window
# Add to ~/.bashrc
eval "$(coverctl completion bash)"

Next Steps

Section titled “Next Steps”