Extensions

Visual Studio Extension

The GauntletCI extension for Visual Studio 2022 runs behavioral change risk detection on your commits and surfaces findings directly in the Error List and Output window - no terminal required.

Requirements

  • Visual Studio 2022 (17.0 or later)
  • GauntletCI CLI: dotnet tool install -g GauntletCI

Install

Via the VS Marketplace

  1. Open Visual Studio 2022.
  2. Go to Extensions > Manage Extensions.
  3. Search for GauntletCI in the Online tab.
  4. Click Download, then close and restart Visual Studio.

Via .vsix (manual)

  1. Download the latest .vsix from GitHub Releases.
  2. Double-click the file to open the VSIX installer.
  3. Click Install, then restart Visual Studio.

How to use

Open a .NET solution. After making changes, run the analysis from the menu:

Tools > GauntletCI > Analyze Current Commit

Error List output mockup

Error List2 Errors1 Warning
CodeDescriptionFileLine
GCI0001Logic change without test coverageOrderService.cs42
GCI0003Public API breaking change: method removedIOrderService.cs18
GCI0012Exception swallowed without loggingPaymentHandler.cs87

Double-clicking an Error List entry navigates to the affected line. Each entry in the Output window includes the rule ID, which links to the full rule description at gauntletci.com/docs/rules.

Settings

Configure via Tools > Options > GauntletCI > General.

OptionDefaultDescription
ExecutablegauntletciFull path to the CLI if not on PATH.
Sensitivitybalancedstrict, balanced, or permissive.
Disable LLMtrueSkip LLM enrichment for faster local analysis.

Troubleshooting

"gauntletci" is not recognized

The CLI is not on your PATH. Either run dotnet tool install -g GauntletCI and restart Visual Studio, or set the full path in Options > GauntletCI > Executable.

No findings after analysis

Analysis runs against the most recent commit, not staged changes. If you have uncommitted edits, commit them first. You can also run gauntletci analyze --staged directly in the terminal from VS View > Terminal.

Extension does not appear in the Tools menu

Confirm the extension installed successfully under Extensions > Manage Extensions > Installed. If it is listed but the menu item is missing, try Tools > Customize... to reset the menu.

Source and releases

Source code and releases are at EricCogen/GauntletCI-VisualStudio.