Skip to content

WhatTheDiff

WhatTheDiff

AI tool that generates PR descriptions and reviews changes in natural language.

Official Site
01

Overview

WhatTheDiff is an AI-powered code review tool that automatically analyzes pull requests, identifies bugs, security issues, and style violations, and suggests improvements. By leveraging large language models and static analysis, it provides contextual feedback that goes beyond traditional linters, helping teams catch defects before merge and maintain consistent code quality at scale.

02

Getting Started

Install WhatTheDiff by connecting it to your Git hosting platform (GitHub, GitLab, or Bitbucket) via its marketplace app or OAuth flow. Once installed, it automatically hooks into pull request events. Configure review rules in a YAML config file at the repository root to tailor severity, ignored paths, and language-specific checks.

bash
# Install via GitHub Marketplace (or GitLab CI)
# 1. Open your repo settings → Integrations → WhatTheDiff
# 2. Grant read access to code + write access to PR comments

# Optional: add a config file
cat > .whatthediff.yml <<'EOF'
review:
  severity: warn          # warn | error
  ignore: ["dist/**", "vendor/**"]
  languages: [typescript, python, go]
EOF
03

Use Cases

Typical use cases for WhatTheDiff: (1) automated PR review on every push, gating merges on critical findings; (2) incremental scanning of only changed files for fast feedback; (3) security-focused review detecting injection, hardcoded secrets, and unsafe deserialization; (4) architectural review enforcing layering and dependency rules; (5) onboarding new contributors with inline explanations of why a pattern is flagged.

04

Tips

Tips for getting the most out of WhatTheDiff: start in "advisory" mode (comments only, no merge blocking) to calibrate noise, then progressively enforce critical rules. Use path-based rule overrides so generated or vendored code is skipped. Pair WhatTheDiff with a human reviewer rotation so context-heavy design decisions still get human judgment. Review the tool's findings dashboard weekly to tune false positives.

Ready to try WhatTheDiff?

Visit the official site for the latest version and full documentation.

Visit WhatTheDiff