Documentation

Getting Started

GauntletCI is a local-first change risk engine for C# and .NET. It analyzes pull request diffs to catch breaking changes and regressions before they merge, with no cloud connection required.

Install

$ dotnet tool install -g GauntletCI

Requires .NET 8 or later.

Run your first analysis

$ gauntletci analyze --staged

# Analyze your staged changes before committing

$ gauntletci analyze --diff pr.diff

# Analyze a saved diff file

$ git diff HEAD | gauntletci analyze

# Pipe a diff from stdin

Install as a pre-commit hook

Run this once inside your repository. GauntletCI will analyze your staged diff automatically before every commit.

$ gauntletci init

The hook runs gauntletci analyze --staged and exits with code 1 if findings are detected, blocking the commit.

What it analyzes

GauntletCI reads the exact lines added and removed in your diff and evaluates them against 20+ deterministic rules. It flags:

  • +Behavior changes without corresponding test updates
  • +Breaking public API or method signature changes
  • +New exception paths with no callers prepared to handle them
  • +Removed null guards or defensive checks
  • +Implicit dependency behavior shifts
  • +Hardcoded secrets and SQL injection risks

What it is not

GauntletCI is not a linter, formatter, test runner, or full-codebase static analysis replacement. It focuses on one question: did this diff introduce behavior that is no longer properly validated?

It runs alongside your existing tools; it does not replace them.

Next steps