🧪 vibecheck

Your AI wrote it. Your name's on it. Now prove you read it.

vibecheck blocks git push until you pass a quick multiple-choice quiz on the diff your coding assistant is shipping. Pass and it goes through. Not in the mood? Skip — it's always offered, no nagging.

Know your own change and it's a few seconds. Watched the AI write 400 lines you didn't read? That's exactly the point.

Install

Claude Code — two commands, nothing touched in your repo:

/plugin marketplace add dalvgit/vibecheck
/plugin install vibecheck

OpenCode or Codex CLI — see adapters/.

What to expect

• 2–4 multiple-choice questions on the diff you're about to push — not the whole repo, just what's new.
• Only fires on pushes your coding assistant makes (not your own terminal), and only when there's real code going out (docs, lockfiles, and trivial changes are skipped).
• A skip is always there. vibecheck is a nudge, not a wall.

Optional — drop a .vibecheck.toml to tune it:

[quiz]
questions = 3          # 2–4
pass = "majority"      # "majority" (>50%) | "all"
[gate]
ignore = ["*.lock", "dist/**", "*.md", "package-lock.json"]

Good to know

It's a nudge, not a lock — a habit-breaker against rubber-stamping AI diffs. The model runs your commands, so it could skip the exam.

Questions are written by the model reading your diff — the examiner is plain English in hooks/EXAM-GUIDE.md. Dull questions are bugs; PRs welcome.

MIT