Cause: JavaScript error in extension files

Fix:

1. Go to chrome://extensions/
2. Click "Errors" button on the extension card
3. Check which file has the error
4. Reload extension after fixing

Cause: Using browser APIs in service worker

Cause: Provider not selected or settings not saved

Fix:

1. Click extension icon in Chrome toolbar
2. Select a provider from the grid
3. Enter your API key
4. Click "Save Configuration"
5. Wait for "Configuration saved" message

Cause: Wrong API key format or copied with extra spaces

Expected Formats:

• Claude: Must start with sk-ant-
• OpenAI: Must start with sk-
• Gemini: Must start with AIza
• HuggingFace: Must start with hf_
• Ollama: No API key needed!

Tips:

• Copy entire key without spaces
• Don't include quotes
• Generate new key if unsure

Fix:

1. Check Chrome storage in console:
   // Open popup, press F12, run in console: chrome.storage.sync.get(null, console.log)
2. If empty, try:
   • Clear browser cache
   • Reload extension
   • Re-enter settings

Cause: Claude API requires special header for browser requests

Possible Causes: Invalid API key, network connectivity, API endpoint down, or CORS blocking

Fix:

1. Check API Key:

• Go to provider's dashboard
• Verify key is active
• Generate new key if needed

2. Check Network:

3. Check Provider Status:

• Anthropic Status
• OpenAI Status
• Google Status

4. Try Different Provider:

• Switch to Gemini (has free tier)
• Or use Ollama (local, no network needed)

Fix:

1. Click "Test Connection" button manually
2. Check console for detailed error (press F12)
3. Verify you clicked "Save Configuration" first
4. Try selecting provider again

Fix:

Fix:

Fix:

1. Check endpoint in extension: http://localhost:11434
2. Verify Ollama port:
   # Windows netstat -an | findstr 11434 # Mac/Linux netstat -an | grep 11434
3. Test manually:
   curl http://localhost:11434/api/tags # Should list your models

Cause: MutationObserver triggered by own changes

Fix:

1. Try selecting text again - ensure selection is not empty
2. Check if page uses standard text selection
3. Try custom selectors:
   • Right-click → Inspect element
   • Note the class/ID of output area
   • Add in extension Settings tab
4. Refresh page after saving

Fix:

1. Open browser console (F12)
2. Select text and click the hover button
3. Check for errors in console

Common issues:

• No provider configured
• API key missing
• Network blocked

Fix:

1. Verify button shows "Insert Improved Script"
2. Check if input field is contenteditable or textarea
3. Try clicking in input field first
4. Check console for errors (F12)

Fix:

1. Right-click extension icon → "Inspect popup"
2. Check console for errors
3. Reload extension from chrome://extensions/
4. Try restarting Chrome

Fix:

• Wait 60 seconds before retrying
• Upgrade to higher tier in Anthropic console
• Switch to different provider temporarily

Fix:

1. Go to OpenAI Billing
2. Add payment method
3. Add credits to your account

Fix:

1. Go to Google Cloud Console
2. Enable "Generative Language API"
3. Wait 5 minutes for propagation
4. Try again

Fix:

1. Go to Azure Portal
2. Check your deployment name (case-sensitive!)
3. Update in extension settings
4. Verify endpoint URL format:
   https://YOUR-RESOURCE.openai.azure.com