Getting Started

Install Vigil and get your first verification score in under 2 minutes.

Whether your PRs are written by humans, AI coding agents like Claude Code, Cursor, or GitHub Copilot, or a mix of both — Vigil verifies that what the PR claims to do matches what the code actually does. Zero config, zero friction.

1. Install the GitHub App

Head to the Vigil GitHub App page and click Install. The entire process takes about 30 seconds.

Choose which repositories Vigil should monitor. You can grant access to all repositories in your organization or select specific ones. Vigil only needs read access to pull requests and write access to checks and comments.

2. Open a Pull Request

Open any pull request. Vigil automatically analyzes the diff and PR description across six verification signals: claims verification, undocumented change detection, credential scanning, coverage mapping, contract checking, and diff analysis.

No test plan is required. Vigil reads your PR title and description, extracts claims, and verifies them against the actual code changes. It also catches changes you forgot to mention.

3. See your verification score

Once the PR is opened or updated, Vigil automatically:

• Reads the PR title and description to extract claims
• Analyzes the diff for undocumented changes
• Scans for leaked credentials
• Checks test coverage for changed files
• Calculates a weighted verification score from 0 to 100
• Posts results as a PR comment and GitHub Check Run

Vigil Verification Score: 85/100 — Safe to merge

| Signal              | Score | Status |
|---------------------|-------|--------|
| Claims Verifier     |    92 |   Pass |
| Undocumented Changes|    78 |   Pass |
| Credential Scan     |   100 |   Pass |
| Coverage Mapper     |    70 |   Pass |
| Contract Checker    |    85 |   Pass |
| Diff Analyzer       |    90 |   Pass |

Optional: Add configuration

Vigil works out of the box with zero configuration. If you need to customize notifications, auto-approval thresholds, or coverage exclusions, drop a .vigil.yml file in your repository root. See the Configuration page for the full reference.