Cursor worked fine yesterday. You were building, everything was smooth. Today you open it and:
- Won't start at all
- Opens but immediately freezes
- Crashes every few minutes
- Suggestions stopped appearing
- The chat window is blank
You've tried restarting. Didn't help. You've tried restarting your computer. Still broken.
Here's how to actually fix it.
Quick Fixes (Try These First) #
Fix #1: Clear Cursor's Cache (2 minutes) #
Cursor stores temporary files that can corrupt. Clear them:
On Mac:
rm -rf ~/Library/Application\ Support/Cursor/Cache
rm -rf ~/Library/Application\ Support/Cursor/GPUCacheOn Windows:
Delete: C:\Users\[YourName]\AppData\Roaming\Cursor\Cache
Delete: C:\Users\[YourName]\AppData\Roaming\Cursor\GPUCache
On Linux:
rm -rf ~/.config/Cursor/Cache
rm -rf ~/.config/Cursor/GPUCacheThen restart Cursor.
Fix #2: Reset Cursor Settings (5 minutes) #
Sometimes your settings file gets corrupted.
On Mac:
mv ~/Library/Application\ Support/Cursor/User/settings.json ~/Library/Application\ Support/Cursor/User/settings.json.backupOn Windows:
Rename: C:\Users\[YourName]\AppData\Roaming\Cursor\User\settings.json
to: settings.json.backup
On Linux:
mv ~/.config/Cursor/User/settings.json ~/.config/Cursor/User/settings.json.backupRestart Cursor. It will create new default settings.
Fix #3: Reinstall Cursor (10 minutes) #
If above didn't work:
- Uninstall Cursor completely
- Delete leftover files:
- Mac:
~/Library/Application Support/Cursor - Windows:
C:\Users\[YourName]\AppData\Roaming\Cursor - Linux:
~/.config/Cursor
- Mac:
- Download fresh copy from cursor.sh
- Install and sign in again
Specific Problems & Fixes #
Problem: Cursor Opens But Chat Doesn't Work #
Symptoms: Cursor starts fine but AI chat is blank or doesn't respond.
Fix:
- Check your API key is valid (Settings → API Keys)
- Try switching models (GPT-4 → Claude → GPT-3.5)
- Check internet connection
- Sign out and sign back in
If still broken:
## Clear chat history
rm -rf ~/Library/Application\ Support/Cursor/User/workspaceStorageProblem: Cursor Crashes When Opening Projects #
Symptoms: Works on new files but crashes when opening your project.
Fix:
Your project might have corrupted Cursor workspace data.
In your project folder:
rm -rf .cursor
rm -rf .vscodeThen open project again in Cursor.
Problem: Suggestions Stopped Appearing #
Symptoms: Cursor works but autocomplete/suggestions gone.
Fix:
- Check if Copilot++ is enabled (Settings → Features)
- Try toggling it off and on
- Check if you hit your usage limit (free tier has limits)
- Restart Cursor with cache cleared
Problem: Cursor Incredibly Slow #
Symptoms: Everything takes forever, typing lags, freezes constantly.
Fix:
- Close large files (10,000+ lines)
- Disable extensions you don't need
- Clear cache (Fix #1 above)
- Check if indexing is running (bottom right corner)
- Close other resource-heavy apps
Problem: "Failed to Start" Error #
Symptoms: Error message on startup about failing to start.
Fix:
Usually caused by permission issues or corrupted installation.
On Mac:
sudo chown -R $(whoami) ~/Library/Application\ Support/CursorOn Windows: Run Cursor as Administrator once, then normal.
On Linux:
sudo chown -R $USER:$USER ~/.config/CursorWhen It's Not Cursor - It's Your Project #
Sometimes the issue isn't Cursor breaking - it's your project getting too complex for Cursor to track.
Signs this is the actual problem:
- ✅ Cursor works fine on new projects
- ✅ Cursor works fine on small files
- ✅ Suggestions are wrong (not missing)
- ✅ Cursor suggests things that break your code
- ✅ Takes forever to generate responses
If this sounds familiar, the issue is Cursor losing track of your project.
🔧 Fix Cursor Confusion (Not Technical Issues)
If Cursor runs fine but suggestions are wrong or break your code, it's not a technical problem - Cursor lost track of your project. Giga helps Cursor understand your entire codebase.
Fix Cursor suggestions →Advanced Fixes #
Reset Cursor Completely (Nuclear Option) #
If nothing else worked:
- Uninstall Cursor
- Delete ALL Cursor data:
# Mac rm -rf ~/Library/Application\ Support/Cursor rm -rf ~/Library/Preferences/com.cursor.* rm -rf ~/Library/Saved\ Application\ State/com.cursor.* # Windows Delete: C:\Users\[YourName]\AppData\Roaming\Cursor Delete: C:\Users\[YourName]\AppData\Local\Cursor # Linux rm -rf ~/.config/Cursor rm -rf ~/.cache/Cursor - Restart computer
- Fresh install of Cursor
- Sign in, reconfigure settings
Warning: This deletes all your settings, extensions, chat history.
Check System Requirements #
Make sure your system can actually run Cursor:
Minimum:
- 4GB RAM (8GB recommended)
- 1GB free disk space
- Internet connection
- Modern OS (not ancient Windows 7)
If you're on minimum specs and Cursor keeps crashing, you might need to upgrade hardware.
Network/Firewall Issues #
If Cursor won't connect:
- Check firewall isn't blocking Cursor
- Try different network (phone hotspot?)
- Check if VPN is interfering
- Corporate network might block AI services
Prevention (So This Doesn't Happen Again) #
1. Don't max out your system
- Close unused apps when using Cursor
- Don't open 50+ files at once
- Give Cursor at least 4GB RAM to work with
2. Keep Cursor updated
- Update when prompted
- Check cursor.sh occasionally for new versions
3. Regular cache clearing
- Clear cache monthly if you use Cursor daily
- Prevents buildup of corrupted files
4. Backup your settings
- Export your settings occasionally
- Makes recovery easier if you need to reinstall
When to Actually Contact Support #
Try all fixes above first. But contact Cursor support if:
- Problem persists after complete reinstall
- Only happens on your machine (works for others)
- Started after a specific Cursor update
- Error messages you can't Google
- Account/billing issues
Cursor support: support@cursor.sh
Include:
- What you tried
- Error messages (screenshots)
- Your OS and Cursor version
- When it started
Common Questions #
Will I lose my work if I reinstall? #
No. Your code is in your project folders, not in Cursor. Reinstalling Cursor doesn't touch your projects.
You'll lose: Settings, extensions, chat history. Your code is safe.
Why does Cursor break so often? #
It doesn't for most people. If yours breaks constantly:
- Might be system resource issue
- Might be conflicting software
- Might be corrupted installation
- Or your project needs better context management
Should I switch to VS Code? #
If technical issues: Try fixes above first.
If suggestion quality issues: It's not Cursor - it's your project complexity. Switching won't help.
Does Giga fix technical issues? #
No. Giga doesn't fix crashes, freezes, or Cursor not starting.
Giga fixes: Cursor making wrong suggestions, breaking your code, forgetting your project structure.
Two different problems, two different solutions.
What to Do Right Now #
If Cursor won't start or crashes:
- Clear cache (Fix #1)
- Try reinstall (Fix #3)
- Contact support if still broken
If Cursor works but suggestions are wrong:
- This isn't a technical issue
- Your project outgrew Cursor's memory
- Add context management
