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
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.
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.
