Cursor + OpenRouter Setup

Why OpenRouter for Cursor

OpenRouter provides access to many models including free options. Good as a primary provider or fallback when Gemini hits rate limits.

Step 1: Get an OpenRouter Key

Go to openrouter.ai/keys
Sign up and create a key (starts with sk-or-)

Step 2: Configure VibeLearn

mkdir -p ~/.vibelearn
cat > ~/.vibelearn/settings.json << 'EOF'
{
  "VIBELEARN_OPENROUTER_API_KEY": "sk-or-YOUR_KEY_HERE",
  "VIBELEARN_OPENROUTER_MODEL": "google/gemini-2.0-flash-exp:free"
}
EOF

Free model options:

google/gemini-2.0-flash-exp:free — recommended
xiaomi/mimo-v2-flash:free — fast, smaller context

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

curl http://127.0.0.1:37778/api/readiness
# → {"status":"ready"}

Run an agent session, then vl quiz to see questions.

Combining Gemini + OpenRouter

For maximum reliability, configure both:

{
  "VIBELEARN_GEMINI_API_KEY": "AIza...",
  "VIBELEARN_OPENROUTER_API_KEY": "sk-or-..."
}

VibeLearn tries Gemini first. If it fails or hits rate limits, it falls back to OpenRouter automatically.

Troubleshooting

No output / empty response — Free models may be slow or at capacity. Try a different free model. 402 Payment Required — Model requires credits. Switch to a :free model or add OpenRouter credits. Check which provider was used:

grep "provider" ~/.vibelearn/logs/vibelearn-$(date +%Y-%m-%d).log | tail -5

Get Started

AI Providers

Cursor Integration

Configuration & Development

Architecture

Cursor + OpenRouter Setup

Why OpenRouter for Cursor

Step 1: Get an OpenRouter Key

Step 2: Configure VibeLearn

Step 3: Install Cursor Hooks

Step 4: Verify

Combining Gemini + OpenRouter

Troubleshooting

​Why OpenRouter for Cursor

​Step 1: Get an OpenRouter Key

​Step 2: Configure VibeLearn

​Step 3: Install Cursor Hooks

​Step 4: Verify

​Combining Gemini + OpenRouter

​Troubleshooting

Why OpenRouter for Cursor

Step 1: Get an OpenRouter Key

Step 2: Configure VibeLearn

Step 3: Install Cursor Hooks

Step 4: Verify

Combining Gemini + OpenRouter

Troubleshooting