Common Issues
Solutions for common problems and FAQs
Below are common issues and their solutions.
Networking Issues
First, check your network connectivity. Go to Cursor Settings > Network and click Run Diagnostics. This will test your connection to Cursor’s servers and help identify any network-related issues that might be affecting AI features, updates, or other online functionality.
Cursor relies on HTTP/2 for AI features because it handles streamed responses efficiently. If your network doesn’t support HTTP/2, you may experience indexing failures and AI feature issues.
This occurs on corporate networks, VPNs, or when using proxies like Zscaler.
To resolve this, enable HTTP/1.1 fallback in app settings (not Cursor settings): press CMD/CTRL + ,, search for HTTP/2, then enable Disable HTTP/2. This forces HTTP/1.1 usage and resolves the issue.
We plan to add automatic detection and fallback.
Resource Issues (CPU, RAM, etc.)
High CPU or RAM usage can slow your machine or trigger resource warnings.
While large codebases require more resources, high usage typically stems from extensions or settings issues.
If you are seeing a low RAM warning on MacOS, please note that there is a bug for some users that can show wildly incorrect values. If you are seeing this, please open the Activity Monitor and look at the “Memory” tab to see the correct memory usage.
If you’re experiencing high CPU or RAM usage, try these steps:
Check Your Extensions
Check Your Extensions
Extensions can impact performance.
Test by running cursor --disable-extensions from the command line. If performance improves, re-enable extensions one by one to identify problematic ones.
Try Extension Bisect to identify problematic extensions. Read more here. Note: this works best for immediate issues, not gradual performance degradation.
Use the Process Explorer
Use the Process Explorer
The Process Explorer shows which processes consume resources.
Open it: Command Palette (Cmd/Ctrl + Shift + P) → Developer: Open Process Explorer.
Review processes under:
extensionHost: Extension-related issuesptyHost: Terminal resource consumption
The Process Explorer displays each terminal and its running commands for diagnosis.
For other high-usage processes, report to the forum.
Monitor System Resources
Monitor System Resources
Use your operating system’s monitoring tools to determine if the issue is Cursor-specific or system-wide.
Testing a Minimal Installation
Testing a Minimal Installation
If issues persist, test a minimal Cursor installation.
General FAQs
I see an update on the changelog but Cursor won't update
I see an update on the changelog but Cursor won't update
New updates use staged rollouts - randomly selected users receive updates first. Expect your update within a few days.
I have issues with my GitHub login in Cursor / How do I log out of GitHub in Cursor?
I have issues with my GitHub login in Cursor / How do I log out of GitHub in Cursor?
Use Sign Out of GitHub from the command palette Ctrl/⌘ + Shift + P.
I can't use GitHub Codespaces
I can't use GitHub Codespaces
GitHub Codespaces isn’t supported yet.
I have errors connecting to Remote SSH
I have errors connecting to Remote SSH
SSH to Mac or Windows machines isn’t supported. For other issues, report to the forum with logs.
SSH Connection Problems on Windows
SSH Connection Problems on Windows
If you see “SSH is only supported in Microsoft versions of VS Code”:
-
Uninstall Remote-SSH:
- Open Extensions view (
Ctrl + Shift + X) - Search “Remote-SSH”
- Click gear icon → “Uninstall”
- Open Extensions view (
-
Install Anysphere Remote SSH:
- Open Cursor marketplace
- Search “SSH”
- Install the Anysphere Remote SSH extension
-
After installation:
- Close all VS Code instances with active SSH connections
- Restart Cursor
- Reconnect via SSH
Verify your SSH configuration and keys are properly set up.
Cursor Tab and Inline Edit do not work behind my corporate proxy
Cursor Tab and Inline Edit do not work behind my corporate proxy
Cursor Tab and Inline Edit use HTTP/2 for lower latency and resource usage. Some corporate proxies (e.g., Zscaler) block HTTP/2. Fix by setting "cursor.general.disableHttp2": true in settings (Cmd/Ctrl + ,, search http2).
I just subscribed to Pro but I'm still on the free plan in the app
I just subscribed to Pro but I'm still on the free plan in the app
Log out and back in from Cursor Settings.
When will my usage reset again?
When will my usage reset again?
Pro subscribers: Click Manage Subscription in the Dashboard to view your renewal date.
Free users: Check your first Cursor email date. Usage resets monthly from that date.
My Chat/Composer history disappeared after an update
My Chat/Composer history disappeared after an update
Low disk space may cause Cursor to clear historical data during updates. To prevent this:
- Maintain sufficient free disk space before updating
- Clean up unnecessary system files regularly
- Back up important conversations before updating
How do I uninstall Cursor?
How do I uninstall Cursor?
Follow this guide. Replace “VS Code” or “Code” with “Cursor”, and “.vscode” with “.cursor”.
How do I delete my account?
How do I delete my account?
Click Delete Account in the Dashboard. This permanently deletes your account and all associated data.
How do I open Cursor from the command line?
How do I open Cursor from the command line?
Run cursor in your terminal. If the command is missing:
- Open command palette
⌘⇧P - Type
install command - Select
Install 'cursor' command(optionally installcodecommand to override VS Code’s)
Unable to Sign In to Cursor
Unable to Sign In to Cursor
If clicking Sign In redirects to cursor.com but doesn’t sign you in, disable your firewall or antivirus software - they may block the sign-in process.