Installation

Requirements

Claude Code with plugin support (or Cursor IDE)
Bun — auto-installed if missing
Node.js 18+

Claude Code — Quick Install

/plugin install vibelearn

The plugin installs hooks, starts the worker service on port 37778, and runs the analysis pipeline automatically at the end of each session.

Cursor — Install from Source

git clone https://github.com/anergcorp/vibelearn.git
cd vibelearn
bun install && bun run build

# Install hooks globally (recommended)
bun run cursor:install -- user

# Start the worker
bun run worker:start

Restart Cursor to load the hooks.

Configure an AI Provider

VibeLearn needs an LLM for concept extraction and quiz generation. Provider priority: Gemini → OpenRouter → Anthropic API

Gemini (Free Tier)
OpenRouter
Anthropic (Auto)

Get a free API key at aistudio.google.com/apikey — 1500 requests/day.

~/.vibelearn/settings.json

{
  "VIBELEARN_GEMINI_API_KEY": "AIza..."
}

Get a key at openrouter.ai/keys. Free models available.

~/.vibelearn/settings.json

{
  "VIBELEARN_OPENROUTER_API_KEY": "sk-or-..."
}

Uses ANTHROPIC_API_KEY automatically from the Claude Code environment. No extra configuration needed.

Verify Installation

# Check the worker is running
curl http://127.0.0.1:37778/api/readiness
# → {"status":"ready"}

# After a coding session, check what was captured
vl status

Install from Source (Claude Code)

git clone https://github.com/anergcorp/vibelearn.git
cd vibelearn
npm install
npm run build-and-sync

The build compiles TypeScript → ESM hooks and the worker → bundles with esbuild. Output lands in plugin/ and syncs to ~/.claude/plugins/marketplaces/vibelearn/.

File Locations

Path	Purpose
`~/.vibelearn/vibelearn.db`	SQLite database (all learning data)
`~/.vibelearn/settings.json`	Settings (AI keys, worker config)
`~/.vibelearn/config.json`	Auth config (written by `vl login`)
`~/.vibelearn/logs/vibelearn-YYYY-MM-DD.log`	Worker logs
`~/.claude/plugins/marketplaces/vibelearn/`	Installed plugin files (Claude Code)

Uninstall

# Claude Code
/plugin uninstall vibelearn

Removes the hooks. Your data in ~/.vibelearn/ is preserved.

Get Started

AI Providers

Cursor Integration

Configuration & Development

Architecture

Requirements

Claude Code — Quick Install

Cursor — Install from Source

Configure an AI Provider

Verify Installation

Install from Source (Claude Code)

File Locations

Uninstall

​Requirements

​Claude Code — Quick Install

​Cursor — Install from Source

​Configure an AI Provider

​Verify Installation

​Install from Source (Claude Code)

​File Locations

​Uninstall

Requirements

Claude Code — Quick Install

Cursor — Install from Source

Configure an AI Provider

Verify Installation

Install from Source (Claude Code)

File Locations

Uninstall