Gamified quizzes about your codebase. Replace doomscrolling with learning.
What is RepoOcto?
RepoOcto is a VS Code extension that generates quiz questions about the codebase you're working in. It analyzes your project, understands the architecture, and creates tailored multiple-choice questions to help you (and your team) deeply learn the code.
No API key needed — works out of the box with the built-in AI.
Features
AI-Powered Questions — Automatically generates questions from your actual codebase using Gemini 3.1 Flash Lite
Adaptive Difficulty — Questions scale with your level. Early levels cover project overview and architecture; higher levels dive into edge cases, data flow, and internal logic
Leveling System — Earn XP, level up, and unlock titles from Newcomer to Oracle
Per-Repo Progress — Each repository has its own level and question bank
Spendable XP — Use earned XP to skip tough questions or buy streak freezes
Streak Tracking — Maintain daily streaks with freeze protection
Detailed Explanations — Every answer option includes an explanation so you learn from mistakes
Smart Caching — Summaries and questions are cached and incrementally updated as your code changes
Multiple AI Providers — Built-in (free), Anthropic, OpenAI, OpenRouter, and Google Vertex AI
Sync & Leaderboard — Optionally sign in with GitHub to sync XP across devices and compete on the leaderboard
Getting Started
Install the extension
Open any project in VS Code
Click the RepoOcto icon in the sidebar (or press Ctrl+Shift+Q)
Pick your skill level
Hit "Index Codebase" and start quizzing
That's it. No setup, no API keys, no configuration.
How It Works
Analyzes your codebase to create a compressed representation
Summarizes the codebase into a structured document covering architecture, data flow, patterns, and more
Generates multiple-choice questions tailored to your current level and skill
Tracks your progress, adapting future questions based on what you got wrong
Skill Levels
Level
Title
1-4
Newcomer
5-9
Reader
10-19
Navigator
20-34
Contributor
35-49
Specialist
50-74
Architect
75-99
Guardian
100+
Oracle
Keyboard Shortcuts
Shortcut
Action
Ctrl+Shift+Q / Cmd+Shift+Q
Open RepoOcto
Using Your Own AI Provider
The built-in AI is free and works immediately. If you prefer to use your own API key:
Open RepoOcto Settings
Click "Change API Key"
Select your provider (Anthropic, OpenAI, OpenRouter, or Google Vertex AI)
Enter your API key
Requirements
VS Code 1.85+
Node.js
Privacy
Your code is sent to the AI provider for analysis and question generation
The built-in provider uses Google Gemini via a secure proxy — your code is not stored
Sign-in is optional and only used for XP sync and leaderboard
