{"id":48606768,"url":"https://github.com/covdbg/vscode-covdbg","last_synced_at":"2026-04-15T23:00:30.736Z","repository":{"id":350107494,"uuid":"1185607874","full_name":"covdbg/vscode-covdbg","owner":"covdbg","description":"The official covdbg extension for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2026-04-08T23:30:19.000Z","size":193,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T00:17:44.465Z","etag":null,"topics":["coverage","coverage-report","vscode-extension"],"latest_commit_sha":null,"homepage":"https://covdbg.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/covdbg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-18T19:02:06.000Z","updated_at":"2026-04-08T23:29:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/covdbg/vscode-covdbg","commit_stats":null,"previous_names":["covdbg/vscode-covdbg"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/covdbg/vscode-covdbg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covdbg%2Fvscode-covdbg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covdbg%2Fvscode-covdbg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covdbg%2Fvscode-covdbg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covdbg%2Fvscode-covdbg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/covdbg","download_url":"https://codeload.github.com/covdbg/vscode-covdbg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covdbg%2Fvscode-covdbg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31863499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coverage","coverage-report","vscode-extension"],"created_at":"2026-04-09T00:09:06.713Z","updated_at":"2026-04-15T23:00:30.730Z","avatar_url":"https://github.com/covdbg.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# covdbg for VS Code\n\nNative Windows C++ coverage, directly in VS Code.\n\nRun your executables with coverage, inspect covered and uncovered lines in the editor, open a detailed report, and rerun discovered test binaries from the Testing view. The extension bundles the covdbg runtime for a smoother setup on Windows.\n\n[Get started with covdbg](https://covdbg.com/) | [Product docs and guides](https://covdbg.com/docs/)\n\n## AI Features\n\ncovdbg can also expose native coverage data to chat-capable tooling in VS Code.\n\n- `covdbg_run` runs one or more real test executables with coverage, produces a merged workspace result when multiple executables are used, reloads that result into the extension, and returns structured status plus next-step guidance.\n- If `covdbg.runner.analyzeInputs` is configured, the extension also runs `covdbg analyze` on those binaries and merges the resulting baseline symbol databases into the active workspace result so uncovered-but-never-executed code still shows up.\n- `covdbg_explore` is the workspace-environment discovery entry point for LLMs. It reports where discovered test binaries are, where `.covdbg.yaml` is configured or resolved, where coverage databases are located, and which runtime and runner paths are active.\n- `covdbg_files` lists currently uncovered files from the active loaded workspace coverage result, sorted to help an LLM choose the next file to inspect.\n- `covdbg_code` returns grouped uncovered code segments for a source file, including code snippets, nearby context, file metadata, coverage summary, truncation metadata, and workflow guidance for follow-up actions.\n\nThese tools are designed for iterative workflows where an LLM proposes a fix, you rebuild real test binaries, rerun coverage, and then query the updated uncovered regions again.\n\n### AI Workflow Rules\n\n- Pass real built test executable paths to `covdbg_run`. Do not invent a synthetic aggregate executable such as `all_tests` unless that executable actually exists in the workspace.\n- Do not pass `.covdb` paths back into the LLM workflow. The extension generates, merges, loads, and switches the active coverage result automatically.\n- After coverage is loaded, inspect candidate files with `covdbg_files`, then pass only a source file path to `covdbg_code`. The extension resolves that query against the currently loaded workspace coverage result, including the merged batch result when applicable.\n\n### Example Tool Sequence\n\nRun one or more real test executables and let the extension merge coverage automatically:\n\n```json\n{\n\t\"tool\": \"covdbg_run\",\n\t\"input\": {\n\t\t\"executablePaths\": [\n\t\t\t\"build/tests-suite1.exe\",\n\t\t\t\"build/tests-suite2.exe\"\n\t\t]\n\t}\n}\n```\n\nAsk the extension where covdbg resources are located in the current workspace:\n\n```json\n{\n\t\"tool\": \"covdbg_explore\",\n\t\"input\": {\n\t\t\"workspaceRoot\": \"D:/repo\",\n\t\t\"limit\": 10\n\t}\n}\n```\n\nAsk the extension which files are still uncovered in the active merged workspace result:\n\n```json\n{\n\t\"tool\": \"covdbg_files\",\n\t\"input\": {\n\t\t\"limit\": 10,\n\t\t\"maxCoveragePercent\": 80\n\t}\n}\n```\n\nInspect a specific source file from that active workspace result:\n\n```json\n{\n\t\"tool\": \"covdbg_code\",\n\t\"input\": {\n\t\t\"filePath\": \"src/widget.cpp\"\n\t}\n}\n```\n\nThe intended loop is: build real test executables, run coverage, let the extension load the merged workspace result, inspect uncovered files, fix code, rebuild, and rerun coverage.\n\n## See Coverage In VS Code\n\n\u003cimg src=\"https://media.githubusercontent.com/media/covdbg/vscode-covdbg/main/gif/readme-demo.gif\" width=800 height=500\u003e\n\ncovdbg brings the full coverage workflow into the editor: launch a target, reload results automatically, review inline highlights, and drill into file, folder, and function details without bouncing between separate tools.\n\n### Scope coverage with `.covdbg.yaml`\n\nChoose the test executable from covdbg's discovered binaries, then use `.covdbg.yaml` to decide what should actually count in the report. This config is where you include or exclude files and functions for that run and where you keep third-party code, SDKs, vendored dependencies, and helper-only test code out of your numbers.\n\n```yaml\nversion: 1\nsource_root: \".\"\ncoverage:\n\tdefault:\n\t\tfiles:\n\t\t\tinclude:\n\t\t\t\t- \"**/*.cpp\"\n\t\t\t\t- \"**/*.h\"\n\t\t\texclude:\n\t\t\t\t- \"tests/helpers/**\"\n\t\t\t\t- \"third_party/**\"\n\t\t\t\t- \"external/**\"\n\t\t\t\t- \"vendor/**\"\n\t\t\t\t- \"**/Windows Kits/**\"\n\t\t\t\t- \"**/VC/Tools/MSVC/**\"\n\n\t\tfunctions:\n\t\t\tinclude:\n\t\t\t\t- \"*\"\n\t\t\texclude:\n\t\t\t\t- \"__scrt_*\"\n\t\t\t\t- \"_RTC_*\"\n\t\t\t\t- \"__security_*\"\n```\n\nUse `covdbg: Create .covdbg.yaml` to generate a starter config in the workspace and tailor it to your binaries, test layout, and dependency boundaries.\n\n## Why covdbg\n\nGetting useful coverage for native Windows C++ is usually more work than it should be. covdbg is built to make that workflow practical:\n\n- Use your existing Windows binaries and debug symbols.\n- Avoid compiler-specific instrumentation workflows and extra build-system churn.\n- Review coverage where you already edit and debug.\n- Move from a single run to actionable file and function detail quickly.\n- Keep coverage local to your machine and workspace.\n\n## What You Get In The Extension\n\n### Run coverage without leaving the editor\n\nChoose a target executable, start a coverage run from VS Code, and let the extension reload the latest result automatically.\n\n### Inline coverage that stays close to the code\n\nShow covered and uncovered lines with gutter markers, line highlights, or both, so gaps are visible while you work.\n\n### Interactive report for deeper inspection\n\nOpen a report with file and folder summaries, per-file statistics, and function-level detail when you want more than a line overlay.\n\n### Testing UI integration\n\nDiscover likely test binaries in your workspace and rerun them with coverage from the built-in Testing view.\n\n### AI-assisted coverage workflows\n\nUse the chat tools to ask for uncovered code in a file, apply a fix, rebuild, run the target again with coverage, and inspect the refreshed gaps without leaving VS Code.\n\n### Sidebar home dashboard\n\nOpen the covdbg activity bar item to get a live onboarding and status dashboard for the current workspace: license state, runtime resolution, discovered tests, loaded coverage, config health, and the next actions to take.\n\n### Flexible result loading\n\nPoint covdbg at an existing coverage result or let it discover results in your workspace automatically.\n\n## Quick Start\n\n1. Install the extension on Windows.\n2. Open your C++ workspace in VS Code.\n3. Open the covdbg sidebar to verify runtime, license, config, and target status.\n4. Add or generate `.covdbg.yaml` so the report includes the right project files and excludes SDK or third-party noise.\n5. Run `covdbg: Run Coverage` and choose from the discovered test binaries.\n6. Review coverage inline or open `covdbg: Show Coverage Report`.\n\nIf you already have a coverage result, use `covdbg: Select .covdb File...` and start browsing immediately.\n\nThe covdbg status bar entry is always available after startup. If no `.covdbg.yaml` is present yet, the extension can offer to create one for you.\n\n## Typical Workflows\n\n### Run a native test binary with coverage\n\nRun `covdbg: Run Coverage`, choose a discovered test executable, and optionally use `covdbg.runner.targetArgs` for extra arguments.\n\n### Include uncovered lines from app binaries\n\nSet `covdbg.runner.analyzeInputs` to one or more workspace-relative or absolute binary paths when you want a default baseline for every test target in the workspace.\n\nIf different test executables need different baselines, use `covdbg.runner.analyzeInputsByTarget` instead. Each key can be an exact executable path, a basename such as `ui-tests.exe`, or a glob such as `build/**/integration-tests.exe`. The value is the list of binaries to analyze for that test target. Use an empty array to explicitly disable baseline analysis for a matching test executable even when the global default is set.\n\nThe extension resolves target-specific rules first and falls back to `covdbg.runner.analyzeInputs` when no rule matches.\n\n```json\n{\n\t\"covdbg.runner.analyzeInputs\": [\n\t\t\"build/app.exe\"\n\t],\n\t\"covdbg.runner.analyzeInputsByTarget\": {\n\t\t\"build/ui-tests.exe\": [\n\t\t\t\"build/app-ui.exe\"\n\t\t],\n\t\t\"build/unit-tests.exe\": [],\n\t\t\"**/integration-tests.exe\": [\n\t\t\t\"build/app.exe\",\n\t\t\t\"build/plugin-host.exe\"\n\t\t]\n\t}\n}\n```\n\n### Rerun discovered tests from the Testing view\n\nUse `covdbg: Refresh Test Binaries` to discover likely test executables and run them with coverage from the Test Explorer.\n\n### Open and inspect an existing result\n\nUse `covdbg: Select .covdb File...` or set `covdbg.covdbPath` to load an existing result for inline review and reporting.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `covdbg: Open Menu` | Open the main covdbg action menu. |\n| `covdbg: Toggle Coverage Display` | Show or hide inline coverage decorations. |\n| `covdbg: Show Coverage Report` | Open the interactive HTML coverage report. |\n| `covdbg: Browse Covered Files` | Jump to files that have coverage data. |\n| `covdbg: Set Render Mode` | Switch between line, gutter, or combined rendering. |\n| `covdbg: Select .covdb File...` | Load a specific coverage result manually. |\n| `covdbg: Run Coverage` | Run a discovered test executable with coverage. |\n| `covdbg: Create .covdbg.yaml` | Create a starter `.covdbg.yaml` in a workspace folder. |\n| `covdbg: Clear Last Run Result` | Clear the last generated run result from the current workflow. |\n| `covdbg: Refresh Test Binaries` | Refresh executable discovery for the Testing UI. |\n\n## Key Settings\n\n| Setting | Purpose |\n|---------|---------|\n| `covdbg.runner.targetArgs` | Arguments passed to the target executable. |\n| `covdbg.runner.analyzeInputs` | Default binaries to analyze and merge into the final workspace result as uncovered baseline coverage. |\n| `covdbg.runner.analyzeInputsByTarget` | Optional per-test-target analyze rules that override the default baseline for specific executables. |\n| `covdbg.runner.workingDirectory` | Working directory for coverage runs. |\n| `covdbg.runner.outputPath` | Output path for results generated from VS Code. |\n| `covdbg.runner.binaryDiscoveryPattern` | Pattern used to discover test binaries for the Testing UI. |\n| `covdbg.covdbPath` | Load a specific existing coverage result. |\n| `covdbg.discoveryPattern` | Pattern used to discover coverage results automatically. |\n| `covdbg.renderMode` | Choose line, gutter, or both. |\n| `covdbg.showExternalFiles` | Include files outside the workspace in results. |\n\n## Learn More\n\n- Product site: [covdbg.com](https://covdbg.com/)\n- Documentation: [covdbg.com/docs](https://covdbg.com/docs/)\n- Development guide: [DEVELOPMENT.md](https://github.com/covdbg/vscode-covdbg/blob/main/DEVELOPMENT.md)\n- Release notes: [CHANGELOG.md](https://github.com/covdbg/vscode-covdbg/blob/main/CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovdbg%2Fvscode-covdbg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcovdbg%2Fvscode-covdbg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovdbg%2Fvscode-covdbg/lists"}