Documentation

Everything you need to install, configure, and use VibeLearn.

Quick Start

Install VibeLearn as a Claude Code plugin with a single command:

terminal
# Add the VibeLearn plugin
claude mcp add vibelearn -- npx vibelearn

# (Optional) Connect to the cloud dashboard
vl login <your-api-key>

# After your next coding session, try:
vl quiz

That's it. VibeLearn will automatically analyze each session when it ends, extract concepts from your code, and generate quiz questions. No configuration required — it works out of the box.

Get your API key at vibelearn.dev/settings after signing up.

Configuration

Settings are stored in ~/.vibelearn/settings.json and auto-created with defaults on first run.

~/.vibelearn/settings.json
{
  "analysisProvider": "gemini",       // "gemini" | "openrouter" | "anthropic"
  "geminiModel": "gemini-2.0-flash",
  "quizQuestionsPerSession": 7,
  "excludeProjects": [],              // Project names to skip
  "logLevel": "info"                  // "debug" | "info" | "warn" | "error"
}

LLM Providers

  • Gemini (default) — Free tier available. Set GEMINI_API_KEY in your shell environment.
  • OpenRouter — Access multiple models. Set OPENROUTER_API_KEY.
  • Anthropic — Uses Claude Haiku. Set ANTHROPIC_API_KEY.

CLI Reference

vl quiz

Start an interactive quiz from your analyzed sessions. Uses spaced repetition to surface questions at the optimal time.

vl quiz --last

Quiz only from the most recent session.

vl status

View your learning stats: sessions analyzed, top concepts, mastery distribution.

vl gaps

Show concepts with mastery below 50% — your knowledge gaps that need reinforcement.

vl login <api-key>

Connect your local plugin to vibelearn.dev for cloud sync and the web dashboard.

vl sync

Manually re-run the analysis pipeline on the latest session.

Privacy & Data

  • No full code stored — Only short snippets sent to the LLM for analysis, never full files.
  • No absolute paths — Only basenames are sent upstream.
  • No prompts captured — Session analysis only, not your requests to Claude.
  • Privacy tags — Wrap content in <private>...</private> to prevent storage and sync.
  • Local-first — Everything runs on your machine. Cloud sync is opt-in.
  • Anti-tamper — Quiz attempts are HMAC-signed with your API key.

Full source available at github.com/AnerGcorp/vibelearn