Skip to main content

​
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
Get a free API key at aistudio.google.com/apikey — 1500 requests/day.
~/.vibelearn/settings.json
{
  "VIBELEARN_GEMINI_API_KEY": "AIza..."
}

​
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

PathPurpose
~/.vibelearn/vibelearn.dbSQLite database (all learning data)
~/.vibelearn/settings.jsonSettings (AI keys, worker config)
~/.vibelearn/config.jsonAuth config (written by vl login)
~/.vibelearn/logs/vibelearn-YYYY-MM-DD.logWorker 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.