Stop shipping code
you don't understand

A CLI tool that quizzes you on your code changes before you can commit. Pass the quiz, ship the code. Fail, and go read the diff.

$ npm install -g arivcode click to copy Copied!
View on npm → View on GitHub →
arivcode - quiz
$ git commit -m "add auth middleware"
▶ arivcode detected 142 changed lines across 4 files
Generating 12 questions...
Q1/12 What happens if the JWT token is expired when
validateSession() is called?
A) Returns null and continues
B) Throws AuthError and triggers refresh flow
C) Silently redirects to login
D) Logs the user out immediately
✓ Correct!
...
✓ Score: 11/12 (92%) · PASSED · Commit allowed
The Problem

AI writes fast.
Understanding doesn't keep up.

AI coding tools generate hundreds of lines in seconds. Developers accept the suggestions, commit the code, and move on. The code works. Until it doesn't. And when it breaks, nobody can explain what it does or why it was written that way.

52%
of developers don't always review AI-generated code before committing it
Sonar State of Code Survey, 2025 · 1,149 developers
46%
actively distrust AI tool accuracy — yet use these tools daily
Stack Overflow Developer Survey, 2025 · 49,000+ developers
2x
code churn since 2021 — code rewritten within two weeks of being committed
GitClear AI Code Quality Research, 2025 · 211M lines analyzed
How It Works

Three enforcement modes.
Pick the one that fits.

■

Sync Mode

Available Now

Quiz runs at commit time. You answer before the commit goes through. Maximum accountability, strictest enforcement.

01 git commit triggers pre-commit hook
02 arivcode reads staged diff
03 LLM generates quiz questions
04 Pass → commit proceeds
05 Fail → commit blocked
▶

Async Mode

Coming Soon

Commit freely. Quiz runs when you push. All outbound commits are quizzed as one aggregated diff. Your creative flow stays unbroken.

01 Commit as many times as you want
02 git push triggers pre-push hook
03 Quiz on aggregated diff
04 Pass → push goes through
05 Fail → push blocked
★

PR Mode

Coming Soon

Push freely. Quiz appears when a PR is opened. The PR can't merge until the developer passes the quiz. Reviewer is auto-assigned after.

01 Developer opens a PR
02 GitHub App generates quiz from PR diff
03 Developer answers on the web
04 Pass → status check green, reviewer assigned
05 Fail → retake or review the diff
Features

Built for how developers
actually work.

Multi-Provider LLM Support

OpenAI, Google Gemini, and Anthropic Claude. Bring your own API key and pick the model that works for you.

OpenAI · Google · Anthropic

Dynamic Question Scaling

8 questions for small diffs, up to 20 for large ones. Tiered by lines changed so the quiz matches the scope of your work.

8 · 12 · 16 · 20 Questions

4 Focus Areas

Syntax, Execution, Architecture, and Edge Cases. Configure which areas to test, or use all four for comprehensive coverage.

Configurable per project

3 Difficulty Levels

Beginner, Intermediate, or Advanced. Set globally or per project to match your experience level.

Beginner · Intermediate · Advanced

Score in Commit Messages

Optionally badge your commits with your quiz score. Every commit shows you understood the code when you shipped it.

Optional · Configurable

Emergency Bypass

Need to ship a hotfix at 2am? Use --skip to bypass the quiz when you absolutely must commit now.

arivcode quiz --skip
Roadmap

Where we're headed.

arivcode is in active development. Here's what's live, what's next, and what's on the horizon.

Live

CLI: Sync Mode

Pre-commit hook blocks commits until quiz is passed
Multi-provider LLM support (OpenAI, Google, Anthropic)
Dynamic question scaling (8–20 questions by diff size)
3 difficulty levels, 4 focus areas
Per-project and global configuration
Score in commit messages
Emergency bypass with --skip

CLI: Async Mode

Pre-push hook — commit freely, quiz at push time
Aggregated diff quiz across all outbound commits
Local quiz history stored on your machine
Future

Platform — Dashboard & Teams

Web dashboard with quiz history and stats
Public developer profile with quiz terrain heatmap
Team management with admin controls
Managed AI inference — no API key needed
PR Mode — GitHub App quizzes on pull requests
Weakness detection and learning signals
Weekly shareable digest cards
Open Source

Built in the open. MIT licensed.

The CLI is free, open source, and always will be. Star the repo, file issues, submit PRs. This tool gets better when developers shape it.

Star on GitHub View on npm