repoocto

Gamified CLI quizzes about your codebase. Installs a git pre-push hook that generates AI-powered multiple-choice questions about your diff — if you can't explain your own changes, the push is blocked.

No API key needed. Uses a free built-in AI proxy when you sign in with GitHub.

Install

npm install -g repoocto

Usage

# Sign in (one-time, opens browser for GitHub OAuth)
repoocto login

# Install the git pre-push hook in the current repo
repoocto hook install

# From now on, every `git push` runs a quiz about your diff first.
# Bypass in emergencies: git push --no-verify

# Run an on-demand quiz about the current codebase
repoocto quiz

# Show current session and monthly usage
repoocto whoami

# Remove the hook
repoocto hook uninstall

If your team uses Husky, pass --husky to hook install / hook uninstall so the hook is written to .husky/pre-push instead of .git/hooks/pre-push.

How it works

1. On git push, the hook runs repoocto push-quiz.
2. The CLI asks the shared built-in AI proxy to summarize your diff and generate multiple-choice questions about it.
3. You answer. If you score ≥70%, the push proceeds. Otherwise it's blocked.

Questions are about your actual changes — file-level logic, edge cases, data flow — not boilerplate trivia.

VS Code extension

The same AI engine and gamification system is also available as a VS Code extension. Search for RepoOcto in the marketplace, or see the main README.

Repository

Source, issues, and roadmap: https://github.com/hbharmal43/repoocto_extension