Skip to main content

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.

​
Why Gemini for Cursor

When using Cursor without Claude Code, you need to configure an AI provider for VibeLearn’s concept extraction and quiz generation. Gemini’s free tier (1500 req/day) is more than sufficient for daily use.

​
Step 1: Get a Gemini API Key

  1. Go to aistudio.google.com/apikey
  2. Sign in with a Google account
  3. Click Create API key
  4. Copy the key (starts with AIza)

​
Step 2: Configure VibeLearn

mkdir -p ~/.vibelearn
cat > ~/.vibelearn/settings.json << 'EOF'
{
  "VIBELEARN_GEMINI_API_KEY": "AIza_YOUR_KEY_HERE"
}
EOF

​
Step 3: Install Cursor Hooks

# From the vibelearn repo directory
bun run cursor:install -- user
bun run worker:start
Restart Cursor to load the hooks.

​
Step 4: Verify

# Worker should be running
curl http://127.0.0.1:37778/api/readiness
# → {"status":"ready"}
Run an agent session in Cursor, then: 
vl status    # Should show a session analyzed
vl quiz      # Quiz questions from your session

​
Troubleshooting

API key not valid — Key must start with AIza. Re-copy from AI Studio. RESOURCE_EXHAUSTED — Hit the 1500/day free limit. Resets midnight Pacific. Set up OpenRouter as a fallback: 
{
  "VIBELEARN_GEMINI_API_KEY": "AIza...",
  "VIBELEARN_OPENROUTER_API_KEY": "sk-or-..."
}
No quiz questions after session — Check worker logs: 
tail -f ~/.vibelearn/logs/vibelearn-$(date +%Y-%m-%d).log | grep -i "gemini\|error"