Skip to main content

Worker Not Running

Symptom: No quiz questions after sessions. vl status shows no sessions.

No Quiz Questions After Session

Check 1: Was an AI provider configured?
Check 2: Did the analysis pipeline run?
Check 3: Were any files edited? VibeLearn needs Write/Edit observations to generate meaningful concepts. Sessions that only read files may produce no concepts. Check 4: LLM provider errors?

Hooks Not Firing

Claude Code:
  1. Check plugin is installed: /plugin list — should show vibelearn
  2. Verify hooks in ~/.claude/plugins/marketplaces/vibelearn/
  3. Reload Claude Code
Cursor:

Database Issues

Database locked:
Inspect the database directly:

vl quiz Shows No Questions

If 0: No questions generated yet — check LLM provider and run another session. If > 0: CLI issue. Check:

Sync Failures

If status = 'failed' with 5 attempts: sync permanently failed. Check:
  1. vl login <api-key> — verify API key is set
  2. Network connectivity to api.vibelearn.dev
Verify auth status:

Port 37778 Already in Use

Gemini Rate Limit

The free Gemini tier allows 1500 requests/day. VibeLearn uses 2 per session (concepts + quiz), so you can run up to 750 sessions/day on the free tier. If you hit the limit:
  1. Wait until midnight Pacific (resets daily)
  2. Add an OpenRouter key as fallback: "VIBELEARN_OPENROUTER_API_KEY": "sk-or-..."

Check Installed Version

Full Reset (Last Resort)