Cursor + Gemini Setup

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

Go to aistudio.google.com/apikey
Sign in with a Google account
Click Create API key
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"

Get Started

AI Providers

Cursor Integration

Configuration & Development

Architecture

Cursor + Gemini Setup

Why Gemini for Cursor

Step 1: Get a Gemini API Key

Step 2: Configure VibeLearn

Step 3: Install Cursor Hooks

Step 4: Verify

Troubleshooting

​Why Gemini for Cursor

​Step 1: Get a Gemini API Key

​Step 2: Configure VibeLearn

​Step 3: Install Cursor Hooks

​Step 4: Verify

​Troubleshooting

Why Gemini for Cursor

Step 1: Get a Gemini API Key

Step 2: Configure VibeLearn

Step 3: Install Cursor Hooks

Step 4: Verify

Troubleshooting