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
- Open Visual Studio 2022.
- Go to Extensions > Manage Extensions.
- Search for GauntletCI in the Online tab.
- Click Download, then close and restart Visual Studio.
Via .vsix (manual)
- Download the latest
.vsixfrom GitHub Releases. - Double-click the file to open the VSIX installer.
- Click Install, then restart Visual Studio.
How to use
Open a .NET solution. After making changes, run the analysis from the menu:
Error List output mockup
| Code | Description | File | Line |
|---|---|---|---|
| GCI0001 | Logic change without test coverage | OrderService.cs | 42 |
| GCI0003 | Public API breaking change: method removed | IOrderService.cs | 18 |
| GCI0012 | Exception swallowed without logging | PaymentHandler.cs | 87 |
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.
| Option | Default | Description |
|---|---|---|
| Executable | gauntletci | Full path to the CLI if not on PATH. |
| Sensitivity | balanced | strict, balanced, or permissive. |
| Disable LLM | true | Skip 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.
