> ## 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.

# Getting Started

> Your first session with VibeLearn — what happens automatically

## 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:**

```bash theme={null}
/plugin install vibelearn
```

**Cursor:**

```bash theme={null}
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

```json title="~/.vibelearn/settings.json" theme={null}
{
  "VIBELEARN_GEMINI_API_KEY": "AIza..."
}
```

Get a free key at [aistudio.google.com/apikey](https://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:

```bash theme={null}
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

```bash theme={null}
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.

```bash theme={null}
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](/usage/private-tags) for full details.

## Connect to vibelearn.dev

```bash theme={null}
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](https://vibelearn.dev).