Troubleshooting

Cause: No AI provider has been configured

Fix: Go to Settings → AI and add at least one provider (OpenAI, Anthropic, or Ollama)

Cause: Too many requests to the AI provider

Fix: Wait a few minutes, or upgrade to a higher tier plan with your provider

Cause: Invalid message content or corrupted attachments

Fix: Remove any large or corrupt attachments, then try again

Cause: Trying to use codebase features without a folder open

Fix: File → Open Folder to open your project

Cause: Codebase is too large for default indexing

Fix: Add large folders to your ignore file or create an ignore file in the project root

Cause: MCP server configuration is missing or incorrect

Fix: Check Settings → MCP and verify the server command/URL

Cause: Model returned an error or couldn't parse the file

Fix: Try a different model, or check the file for syntax errors

Cause: Git repository issues or conflicts

Fix: Check repository status in your terminal to see if there are conflicts or uncommitted changes

Cause: No provider configured, rate limit, or network issue

Fix: Check Settings and ensure at least one AI provider is set up. If you hit rate limits, wait or switch provider. For network errors, check your connection.

Cause: Large codebase or many files

Fix: Add build output and dependencies to your ignore file so GRID skips them. Use the Rebuild Index command only when needed.

Cause: Shortcut conflict or panel state

Fix: Use the Command Palette and run the Open Chat or Open Sidebar command. Check Keyboard Shortcuts if your shortcut does not work.