repoocto

AI-powered quizzes for your codebase, right from the terminal.

RepoOcto helps developers learn and verify understanding of real code. It can run normal codebase quizzes, or install a pre-push quiz that asks questions about the diff you are about to push.

No API key is required. Sign in with GitHub and RepoOcto uses the built-in AI proxy.

Install

npm install -g repoocto
repoocto login

Choose A Hook Mode

RepoOcto does not guess when installing hooks. Pick the mode that matches how you work.

Shared Team Hook

Use Husky when the hook should live in the repo and be shared with the team:

repoocto hook install --husky
git add .husky/pre-push package.json package-lock.json

Local-Only Hook

Use a local git hook when it should only affect your machine:

repoocto hook install --local

If you type repoocto hook install without a flag, RepoOcto prints both choices and exits.

Daily Commands

repoocto                 # Start an interactive quiz about the current repo
repoocto push-quiz       # Manually run the pre-push quiz
repoocto whoami          # Show current account and monthly usage
repoocto doctor          # Check auth, hook, cache, CLI version, and repo setup
repoocto logout          # Sign out

Uninstall hooks explicitly:

repoocto hook uninstall --husky
repoocto hook uninstall --local

Pre-Push Behavior

On git push, the hook runs:

repoocto push-quiz

RepoOcto generates questions from your diff. Score at least 70% and the push proceeds. Fail or cancel the quiz and the push is blocked.

Setup and infrastructure problems do not block pushes. RepoOcto skips safely if you are not signed in, no terminal is available, generation fails or times out, RepoOcto is not installed, or the diff has no quizzable code changes.

Bypasses:

REPOOCTO_SKIP_HOOK=1 git push
git push --no-verify

Doctor

Run this when setup feels stale or confusing:

repoocto doctor

It checks sign-in state, repo detection, hook state, cache health, CLI version, and whether the hook can run without network fallback. If the hook is stale, it prints the update command.

VS Code Extension

The same engine is available as a VS Code extension with a sidebar quiz experience, progress tracking, levels, XP, and streaks.

Requirements

• Node.js 18+
• Git repository for hook and diff-based quiz features

Repository

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