Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibelearn.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
The Basic Workflow

VibeLearn runs silently in the background. You code normally, and after each session ends, it automatically:
  1. Detects your tech stack
  2. Analyzes the files you edited
  3. Extracts learning concepts
  4. Generates quiz questions
Then you run vl quiz.

​
Step 1: Install

Claude Code: 
/plugin install vibelearn
Cursor: 
git clone https://github.com/anergcorp/vibelearn.git
cd vibelearn && bun install && bun run build
bun run cursor:install -- user
bun run worker:start

​
Step 2: Configure an AI Provider

~/.vibelearn/settings.json
{
  "VIBELEARN_GEMINI_API_KEY": "AIza..."
}
Get a free key at aistudio.google.com/apikey (1500 req/day free).

​
Step 3: Code Normally

Run an agent session. VibeLearn captures every Write, Edit, and Bash tool use via the PostToolUse hook:
ToolWhat’s captured
WriteFile path + content (up to 10KB)
EditFile path + new content (up to 10KB)
BashCommand + output
MCP toolsTool name + inputs + outputs

​
Step 4: Analysis Runs Automatically

Analysis runs after the session ends — when you stop the agent or it finishes its task. The 5-step pipeline takes 30–90 seconds depending on your LLM provider. You can check if analysis completed: 
vl status
# Sessions analyzed: 12
# Total concepts: 87
# Top categories: React (23), Database (15), Auth (12)
# Mastered: 34 | In progress: 41 | Not started: 12

​
Step 5: Take the Quiz

vl quiz

VibeLearn Quiz — 3 questions pending

Question 1/3
React Server Actions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What is the key difference between a Server Action and a regular API route in Next.js?

  A) Server Actions run on the client side
  B) Server Actions are defined with "use server" and execute on the server
  C) Server Actions cannot access databases
  D) Server Actions require a separate endpoint file

Your answer (A/B/C/D): B
✓ Correct! (+1)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Session complete: 2/3 correct (67%)

​
Multi-Session Mastery

After answering quiz questions, your mastery score for each concept updates. Concepts with mastery_score > 0.85 are skipped in future quiz generation — so you focus on what you haven’t fully learned. 
vl gaps
# Concepts you haven't mastered:

# SQLite WAL Mode            ████░░░░░░  38%  (seen 3x)
# HMAC Token Signing         ███░░░░░░░  28%  (seen 2x)
# React Suspense Boundaries  ██░░░░░░░░  22%  (seen 1x)

​
Privacy

To keep something out of VibeLearn entirely, wrap it in <private> tags: 
Please help me with <private>my-secret: abc123</private> — just the config structure
See Private Tags for full details.

​
Connect to vibelearn.dev

vl login <api-key>
vl login --status   # Check current auth
This enables:
  • Server-side mastery computation (authoritative streak and scores)
  • Cross-device sync
  • vibelearn.dev dashboard
Get an API key at vibelearn.dev.