Getting Started

The Basic Workflow

VibeLearn runs silently in the background. You code normally, and after each session ends, it automatically:

Detects your tech stack
Analyzes the files you edited
Extracts learning concepts
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:

Tool	What’s captured
`Write`	File path + content (up to 10KB)
`Edit`	File path + new content (up to 10KB)
`Bash`	Command + output
MCP tools	Tool 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.

Get Started

AI Providers

Cursor Integration

Configuration & Development

Architecture

The Basic Workflow

Step 1: Install

Step 2: Configure an AI Provider

Step 3: Code Normally

Step 4: Analysis Runs Automatically

Step 5: Take the Quiz

Multi-Session Mastery

Privacy

Connect to vibelearn.dev

​The Basic Workflow

​Step 1: Install

​Step 2: Configure an AI Provider

​Step 3: Code Normally

​Step 4: Analysis Runs Automatically

​Step 5: Take the Quiz

​Multi-Session Mastery

​Privacy

​Connect to vibelearn.dev

The Basic Workflow

Step 1: Install

Step 2: Configure an AI Provider

Step 3: Code Normally

Step 4: Analysis Runs Automatically

Step 5: Take the Quiz

Multi-Session Mastery

Privacy

Connect to vibelearn.dev