The most common error strings, what they mean, and the fix. When one isn't obvious, pasting it into the chat usually gets you a direct fix.
Provider & plan errors
Grok CLI not found at /usr/local/bin/grok- The Grok provider is selected but its binary isn't on PATH. Install it, or pick a model that needs no local CLI (Gemini, Groq).
Model is not available in your plan- Plan-level access denied. Upgrade, or choose a model your plan allows from the picker.
content_violation- The content filter flagged the prompt. Rephrase without sensitive terms and resend.
Request & project errors
One or more validation errors occurred- The client sent an incomplete request — usually a stale build. Reload the app and try again.
Project not found or access denied- The project belongs to another account, was deleted, or the GUID in the URL is wrong. Reopen it from your dashboard.
Insufficient credits- Your balance can't cover this generation. It rolls back; upgrade or wait for the monthly reset.
Preview errors
HTTP 502 from preview- The dev server hasn't finished starting. Wait 10–30 seconds and reload the preview.
- Blank page / 404 on entry file
npm installis still running. Wait, then click Retry.
Common mistakes to avoid
- Reacting to the first flash of an error. Some clear themselves once install or startup finishes.
- Paraphrasing the error. Copy the exact string — the AI recognizes exact messages.
FAQ
An error isn't in this list — what do I do?
Paste the exact text into the chat. The AI usually recognizes it and patches the cause, or tells you the fix.
Why do I keep hitting "CLI not found"?
Your selected provider needs a local binary that isn't installed. Switch to Gemini, Groq, or Ollama to avoid it entirely.
Is a 502 something I broke?
No — it just means the preview server is still starting. Give it a few seconds and reload.