Common Issues
Solutions for common problems and FAQs
Below are common issues and their solutions.
If you’re experiencing high CPU or RAM usage, try these steps:
Networking Issues
First, check your network connectivity. Go toCursor 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.
Check Your Extensions
Check Your Extensions
Extensions can impact performance.The Extension Monitor shows resource consumption for all your installed and built-in extensions.Enable the extension monitor from
Settings > Application > Experimental and toggle Extension Monitor: Enabled. This will prompt you to restart Cursor.Open it: Cmd/Ctrl + Shift + P → Developer: Open Extension Monitor.Cursor runs your extensions in one or more extension hosts. Usually, most of your extensions will run in the same extension host, which means an extension consuming a lot of CPU time can suffocate its neighboring extensions!The Extension Monitor will show:- Every long-lived process launched by an extension (MacOS and Linux only).
- % Ext Host: The percentage of total extension host time consumed by this extension. Helps identify which extensions are using the most time relative to others.
- Max Blocking: An extensions’s longest continuous block of execution, per monitoring interval.
- % CPU:
- For extensions: The percentage of total CPU usage attributed to the extension’s code.
- For processes: The percentage of total CPU usage attributed to the launched process (MacOS and Linux only).
- Memory:
- For extensions: The amount of JS heap memory used by the extension’s code (external allocations not counted).
- For processes: The amount of system memory used by the launched process (MacOS and Linux only).
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
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
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.