vibediff 0.1.1

Knows when a PR doesn't belong in your codebase.

VibeDiff

What changed, who wrote it, and does it belong.

---

AI agents write code that compiles, passes tests, and feels completely foreign in your codebase. It works — but it doesn't fit. Your naming is snake_case, the PR is camelCase. Your project uses properties, the PR is full of getter/setter methods straight out of a Java textbook. The author committed 500 lines without changing a single AI-generated variable name.

VibeDiff learns how your project actually writes code, then tells you when a PR doesn't match.

╭──────────────────────────────── VibeDiff ─────────────────────────────────╮
│                                                                           │
│  ████      3 file(s)  +180  -12                                           │
│  ██ ██                                                                    │
│  ██  ██      AI Detection           █████████░░░░░░      58    medium     │
│  ██ ██       Style Drift            ██████░░░░░░░░░      42    medium     │
│  ████        Collaboration          ██████████░░░░░      65    mixed      │
│              Idiom Contamination    ██████░░░░░░░░░      40    medium     │
│                                                                           │
╰──────────────────────────────────────────────────────────────────────────╯

──────────────── AI Detection  58/100 (medium) ─────────────────
  restating_comments    4 comments that restate the code  ███░░
  verbose_names         3/5 functions have 4+ word names  ██░░░
  low_burstiness        CV 0.31 (expected >0.6)           ██░░░

────────────────── Style Drift  42/100 (medium) ────────────────
  naming_convention     expected snake_case, got camelCase ███░░
  comment_density       expected 8%, got 22%               ██░░░

─────────────── Collaboration  65/100 (mixed) ──────────────────
  unresolved_todos      3 TODO comments left in            ██░░░
  generic_names         4/12 variables have generic names  ██░░░

──────────── Idiom Contamination  40/100 (medium) ──────────────
  getter_setter         3 getter/setter methods [java]     ███░░
  error_return_pattern  4 Go-style error returns [go]      ██░░░

Install

pip install vibediff

Usage

vibediff review HEAD~1              # review last commit
vibediff review main..feature       # review a range
vibediff review --pr 42             # review a GitHub PR (requires gh CLI)
vibediff learn                      # learn your codebase conventions
vibediff review HEAD~1 --format json  # JSON output for CI
vibediff review HEAD~1 --format md    # markdown output for PR comments

What it does

Every diff gets a letter grade (A–F) from 4 analyzers:

Analyzer	What it finds
AI Detection	Restating comments, verbose naming, uniform line complexity, excessive is None guards
Style Drift	Naming convention mismatch, comment density deviation, function length drift, import style mismatch
Collaboration	Unresolved TODOs, generic variable names, placeholder stubs, uniform style across files
Idiom Contamination	Java getters in Python, Go error-returns, C-style null checks, JS callback patterns

Style Drift requires a fingerprint — run vibediff learn in your repo first.

GitHub Action

# .github/workflows/vibediff.yml
name: VibeDiff
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: read
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: doncarbon/VibeDiff@main

To enable drift detection, commit your fingerprint and pass it:

      - uses: doncarbon/VibeDiff@main
        with:
          fingerprint: .vibediff-cache/fingerprint.json

---

Built by Hamza · MIT License