Skip to main content

Troubleshooting

Common issues and how to fix them.

Task Issues

Task times out

Symptoms: Task stops before completing.

Solutions:

  1. Break task into smaller steps
  2. Be more specific in your request
  3. Use a faster model (gpt-5-mini)

Agent repeats actions

Symptoms: Same actions repeated, nothing happens.

Solutions:

  1. Rephrase your request more clearly
  2. Start a new conversation
  3. Try a simpler task first

Extension Issues

Extension not showing

Symptoms: No Vibe icon in toolbar.

Solutions:

  1. Go to chrome://extensions
  2. Make sure Vibe is enabled
  3. Click the puzzle icon to pin Vibe to toolbar

Side panel won't open

Solutions:

  1. Right-click the Vibe icon and select "Open side panel"
  2. Use keyboard shortcut Ctrl+Shift+V (Mac: Cmd+Shift+V)
  3. Restart your browser

API Key Issues

"Invalid API key" error

Solutions:

  1. Check your API key has no extra spaces
  2. Verify the key is active at your provider's dashboard
  3. Make sure you have credits/quota remaining

API key not saving

Solutions:

  1. Refresh the settings page
  2. Try entering the key again
  3. Clear browser cache and retry

Performance Issues

Slow responses

Causes:

  • Complex web pages
  • Slow internet connection
  • Provider API delays

Solutions:

  1. Wait for pages to fully load
  2. Use gpt-5-mini for faster responses
  3. Check your internet connection

High API costs

Solutions:

  1. Use gpt-5-mini instead of gpt-4o
  2. Keep requests concise
  3. Start new conversations for unrelated tasks

Getting Help

If problems persist:

  1. Visit GitHub Issues
  2. Include:
    • What you were trying to do
    • What error you saw
    • Your browser and OS