Common issues and fixes.
Arduino core not installed
Symptoms: Compile/Upload disabled or failing.
Fix:
- Open Board Manager → Update Index → Install the required core
- Reopen the Board dropdown and select a matching board
No serial ports detected
Fix:
- Ensure USB cable supports data
- Try a different port
- Open the Port dropdown to refresh
- Install drivers for your board if required
Build fails
Fix:
- Open Output tab to view full logs
- Click "Fix with AI" to get suggestions from the Agent
- Verify FQBN and board options are correct
Git push/pull fails
Fix:
- Check remote URL and credentials
- Set upstream for the current branch
- Fetch → Pull → Push in order
Codebase Indexing Issues
Index not updating after file changes
- Check that Auto-Indexing is enabled in Settings
- Click Re-index Project to force a full rebuild
- Large files (>500KB) are automatically skipped
Semantic search returning no results
- Verify the project is indexed (check Settings → Codebase Indexing)
- Try a different query or search mode
- For exact text matches, use Quick mode or grep search
Indexing taking too long or failing
- Large projects with many files take longer
- Check your internet connection (embeddings require cloud processing)
- Try clearing the index and re-indexing
Datasheet Processing Issues
Processing failed or timed out
- Try a smaller PDF or one with simpler formatting
- Ensure you have a stable internet connection
- Check that the file is a valid PDF
Poor extraction quality
- Complex layouts or scanned documents may not parse well
- Try a different version of the datasheet if available
Update check fails
Fix:
- Verify internet connectivity (indicator on toolbar)
- Try again later; GitHub API rate limits may apply
Terminal rendering issues
Fix:
- Resize the bottom panel to trigger a re‑fit
- Create a new session