# Documentation: C++ Code Coverage on Windows

- Section: Documentation
- Canonical: https://covdbg.com/docs/

---

Guides and reference for covdbg. Start with your first coverage run, connect an AI agent through MCP, or export reports for your team and CI.

Every documentation page is available as Markdown: the links below are those versions. [llms.txt](/llms.txt) summarizes the product for AI assistants, and [ai-catalog.json](/ai-catalog.json) lists the resources for agents.

- [Quick Start Using AI](/docs/getting-started/ai-quick-start.md): one prompt that guides your coding agent through the setup.
- [Installation Guide](/docs/getting-started/installation.md): MSI or portable ZIP, signing in, and system requirements.
- [Quick Start Guide](/docs/getting-started/quick-start.md): build the sample project, run it under covdbg, and read the report.
- [Configuration Reference](/docs/reference/configuration.md): include and exclude patterns, targets, baselines, and settings.

## All pages

- [Changelog](/docs/changelog.md): Release notes for every covdbg version: new features, fixes and changed behaviour, and what to check when you update the CLI, CI and databases.
- [Getting Started](/docs/getting-started.md): Get started with covdbg: install it on Windows, sign in once, and measure the C++ code coverage of your tests in a first report, by hand or with AI.
  - [Installation Guide](/docs/getting-started/installation.md): Install covdbg on Windows 10, 11 or Server with the per-user MSI or the portable ZIP, for x64 or ARM64, and check the system requirements first.
  - [Quick Start Guide](/docs/getting-started/quick-start.md): Measure C++ code coverage on Windows in minutes: build a sample application, run its tests under covdbg, and read the coverage step by step.
  - [Quick Start Using AI](/docs/getting-started/ai-quick-start.md)
- [Guides](/docs/guides.md): Guides to covdbg's coverage reports: export a portable HTML report for the browser, or convert coverage to Cobertura XML, LCOV or GCOV.
  - [Report Formats](/docs/guides/report-formats.md): Export covdbg coverage from a .covdb database to Cobertura XML, LCOV, GCOV or a static HTML report with covdbg convert, for the tools you use.
  - [HTML Reports](/docs/guides/html-reports.md): Turn a covdbg coverage database into a portable static HTML report and review files, functions and uncovered lines in a browser or in CI.
- [Use Cases](/docs/use-cases.md): How teams use covdbg: C++ coverage in CI pipelines, a safety net for refactoring legacy code, open source projects, and large enterprise code.
  - [CI/CD Automation](/docs/use-cases/ci-cd.md): Add C++ code coverage to your CI pipeline with covdbg: fail the build when tests fail, export LCOV or Cobertura, and merge test runs.
  - [Enterprise Software](/docs/use-cases/enterprise.md): C++ code coverage for large enterprise applications on Windows: measure the binaries you ship without rebuilding them, across teams and CI.
  - [Legacy Code Refactoring](/docs/use-cases/legacy-refactoring.md)
  - [Open Source Projects](/docs/use-cases/open-source.md): Add C++ code coverage to your open source project for free: public repositories need only a GitHub sign-in, and GitHub Actions needs no secret.
- [Integrations](/docs/integrations.md): Connect covdbg to your tools: VS Code, CLion, MCP for AI coding agents, GitHub Actions and Codecov, with C++ coverage from your Windows binaries.
  - [MCP Server](/docs/integrations/mcp.md): Connect an AI coding agent to covdbg to run coverage, inspect uncovered source, and measure test improvements. Setup and tool reference.
  - [VS Code Extension](/docs/integrations/vscode.md): C++ coverage in the VS Code gutter on Windows, from your Debug build: no Visual Studio Enterprise, no rebuild. Free for open source and personal use.
  - [CLion Plugin](/docs/integrations/clion.md): Measure C++ code coverage in CLion: run any run configuration under covdbg and see covered, partial and uncovered lines in CLion's coverage view.
  - [GitHub Actions](/docs/integrations/github-actions.md): Measure C++ code coverage in GitHub Actions with covdbg and setup-covdbg on x64 and ARM64 Windows runners, with no secret for public repositories.
  - [Codecov](/docs/integrations/codecov.md): Upload C++ coverage from covdbg to Codecov: convert it to LCOV or Cobertura in CI and see coverage, trends and pull request comments.
- [Reference](/docs/reference.md): covdbg reference: every CLI command and option, the .covdbg.yaml configuration, licensing, data and telemetry, and fixes for common problems.
  - [CLI Command Reference](/docs/reference/cli-reference.md): Every covdbg command and option: run a program under coverage, convert and merge databases, sign in, start the MCP server, and the exit codes.
  - [Configuration Reference](/docs/reference/configuration.md): Configure covdbg with .covdbg.yaml: include and exclude files and functions, leave out lines, choose the DLLs to measure, and override per target.
  - [Troubleshooting](/docs/reference/troubleshooting.md): Fix common covdbg problems: exit codes, sign-in, missing PDBs, nothing measured, DLLs or source files missing from the report, and convert errors.
  - [Licensing FAQ](/docs/reference/licensing-faq.md): How covdbg decides whether a run is licensed: public repositories are free, a signed-in developer gets one private repository, seats cover the rest.
  - [Data and Telemetry](/docs/reference/data-and-telemetry.md): Exactly what covdbg sends to our servers, when, why, and how long we keep it. No source code, file names or coverage data leave your machine.
