Coverctl

coverctl

**Agent-loop coverage governance for all sorts of languages** — coverage your AI coding agent calls before commit, not a dashboard you read after CI.

Works with **Python, TypeScript/JavaScript, Java, Rust, Go, C#, C/C++, PHP, Ruby, Swift, Dart, Scala, Elixir, and Shell** — one `.coverctl.yaml`, one MCP surface. Not a Go cover tool.

[Get started ↓](#get-started) · [Languages ↓](#supported-languages) · [What it looks like ↓](#what-it-looks-like-in-the-agent-loop) · [MCP tools ↓](#mcp-tools) · [CLI reference ↓](#cli-reference) · [Why this exists ↓](#why-this-exists) · [Community ↓](#community)

  

*"Our AI agents ship code fast, but they're blind to coverage policy while editing. We only see breakage in CI, after context is gone, and the same agent then guesses its way to a fix."*

Same policy model on every language: auto-detect the runner, group paths into domains, enforce mins before commit. Mock-heavy or exotic layouts may need an explicit `domains:` block in `.coverctl.yaml`.

coverctl is **not** a Go cover CLI: it is policy + MCP over each language's native coverage runner ([vs `go test -cover` / `pytest --cov`](docs/src/content/docs/compare/coverctl-vs-native.mdx)).

Get started

brew install klarlabs-studio/tap/coverctl

Wire into Claude Code (`~/.config/claude-code/mcp.json`):

{
  "mcpServers": {
    "coverctl": {
      "command": "coverctl",
      "args": ["mcp", "serve"]
    }
  }
}

Ask the agent: *"Run coverctl check and tell me which domains regressed."*

For Cursor / Cline / Claude Desktop / Aider / Continue / OpenCode and other MCP clients, see [docs/src/content/docs/mcp.mdx](docs/src/content/docs/mcp.mdx). All MCP-capable clients work; `coverctl mcp serve` runs in agent mode by default (3 tools: `che