vibelearn

Learn from every session. Built for Claude Code.

Quick Start • How It Works • VL CLI • Configuration • Privacy • Troubleshooting

VibeLearn is a Claude Code plugin that silently watches what you build, extracts the concepts you encounter, and turns them into quiz questions — so you actually retain what you learn while coding.

---

What It Does

Every time you end a Claude Code session, VibeLearn automatically:

1. Detects your tech stack — reads package.json, pyproject.toml, go.mod, etc.
2. Analyzes your code changes — identifies patterns: custom hooks, API routes, TypeScript types, design patterns
3. Extracts learning concepts — a single LLM call produces a session summary and a list of concepts you encountered
4. Generates quiz questions — a second LLM call creates targeted questions per concept across 7 formats: multiple_choice, code_reading, spot_the_bug, fill_in_blank, open_ended, true_false, and ordering — selected based on concept difficulty (junior / mid / senior)
5. Syncs to vibelearn.dev — your learning profile is stored securely (optional, requires vl login)

Then run vl quiz to review what you learned.

---

Quick Start

Install the plugin in a Claude Code session:

/plugin marketplace add anergcorp/vibelearn
/plugin install vibelearn

Restart Claude Code. VibeLearn will start capturing learning data automatically from your next session.

Optional — connect to vibelearn.dev:

vl login <your-api-key>

Get your API key at vibelearn.dev.

---

vl CLI

The vl command lets you review and interact with your learning data:

vl quiz              # Interactive quiz — all pending questions
vl quiz --session    # Quiz questions from the last session only

vl status            # Sessions analyzed, top concept categories, mastery stats
vl gaps              # Concepts you haven't mastered yet (mastery < 50%)

vl login <api-key>   # Connect to vibelearn.dev
vl login --status    # Check login status

Example session:

$ vl quiz

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  VibeLearn Quiz — 3 questions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Q1/3 (intermediate) [React Server Actions]

  Code:
    'use server'
    export async function createPost(data: FormData) { ... }

  What does the 'use server' directive tell Next.js?

  A) Run this function in a Web Worker
  B) Execute this function on the server, not the client
  C) Cache the function result server-side
  D) Mark the function as async-only

  Your answer (A/B/C/D): B

  ✓ Correct!

  Explanation: 'use server' creates a Server Action — a function that
  runs exclusively on the server. The client receives only the result.

Adaptive Difficulty

VibeLearn tracks your mastery per concept and adjusts difficulty automatically:

• 3 correct in a row → promoted to the next level (junior → mid → senior)
• 1 wrong answer → dropped back a level
• Follow-up questions are inserted mid-quiz when you nail a junior question, to probe deeper understanding
• Open-ended answers at senior level are evaluated by a 5-dimension rubric (accuracy, depth, trade-offs, practical reasoning, completeness)

---

How It Works

5 Lifecycle Hooks

SessionStart    → Worker starts, session initialized
UserPromptSubmit → Session linked to user prompt
PostToolUse     → File edits/writes/bash commands captured
Stop (Summary)  → 5-step analysis pipeline runs
SessionEnd      → Session finalized

Analysis Pipeline (runs at session end)