Troubleshooting Guide

This guide covers common issues you might encounter while using the Cursor Reset Tool and their solutions.

Common Issues

1. Permission Denied

Symptom:

• Error message about insufficient privileges
• Script fails to start or modify files

Solutions:

1. Right-click PowerShell and select "Run as Administrator"
2. Verify your Windows user account has administrator privileges
3. Check if antivirus is blocking the script execution

2. Cursor Still Running

Symptom:

• Script warns that Cursor is still running
• Unable to modify files due to locks

Solutions:

1. Close Cursor IDE completely
2. Check Task Manager for any running Cursor processes
3. Use the script's automatic process termination option (respond 'Y' when prompted)

3. Python Not Found

Symptom:

• Error when trying to update SQLite database
• Python-related error messages

Solutions:

1. Install Python from python.org
2. Add Python to your system PATH
3. Continue without Python (SQLite updates will be skipped)

4. Backup Files Missing

Symptom:

• Unable to find .backup files
• Need to restore original configuration

Solutions:

1. Check the same directory as the original files
2. Look for files with .backup extension
3. If no backups exist, reinstall Cursor IDE

5. Script Won't Execute

Symptom:

• PowerShell blocks script execution
• Security warnings

Solutions:

1. Run the following command:

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Unblock the file in Properties
3. Verify the script file isn't corrupted

6. Cursor Won't Start After Reset

Symptom:

• Cursor IDE fails to launch after reset
• Error messages during startup

Solutions:

1. Verify all files were properly updated
2. Check for any .backup files and restore if needed
3. Reinstall Cursor IDE

Recovery Steps

If you need to recover from a failed reset:

1. Restore from Backups

   Copy-Item "%APPDATA%\Cursor\machineId.backup" "%APPDATA%\Cursor\machineId"
   Copy-Item "%APPDATA%\Cursor\User\globalStorage\storage.json.backup" "%APPDATA%\Cursor\User\globalStorage\storage.json"
   Copy-Item "%APPDATA%\Cursor\User\globalStorage\state.vscdb.backup" "%APPDATA%\Cursor\User\globalStorage\state.vscdb"
   

2. Clean Installation

   • Uninstall Cursor IDE
   • Delete the %APPDATA%\Cursor folder
   • Reinstall Cursor IDE
   • Try the reset process again

Getting Help

If you're still experiencing issues:

1. Check the Technical Details for more information
2. Create an issue on GitHub with:
   • Error messages
   • Steps to reproduce
   • System information
3. Try the manual reset process as described in the documentation

Prevention Tips

To prevent issues in future resets:

1. Always run as Administrator
2. Close all instances of Cursor
3. Create manual backups before running the script
4. Keep Python installed and updated
5. Keep PowerShell updated