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

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

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 issues
• ptyHost: 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

Use your operating system’s monitoring tools to determine if the issue is Cursor-specific or system-wide.

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

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?

Use Sign Out of GitHub from the command palette Ctrl/⌘ + Shift + P.

I can't use GitHub Codespaces

GitHub Codespaces isn’t supported yet.

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

If you see “SSH is only supported in Microsoft versions of VS Code”:

1. Uninstall Remote-SSH:

   • Open Extensions view (Ctrl + Shift + X)
   • Search “Remote-SSH”
   • Click gear icon → “Uninstall”

2. Install Remote-SSH version 0.113:

   • Open Cursor marketplace
   • Search “Remote-SSH”
   • Install version 0.113

3. 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 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

Log out and back in from Cursor Settings.

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

Low disk space may cause Cursor to clear historical data during updates. To prevent this:

1. Maintain sufficient free disk space before updating
2. Clean up unnecessary system files regularly
3. Back up important conversations before updating

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?

Click Delete Account in the Dashboard. This permanently deletes your account and all associated data.

How do I open Cursor from the command line?

Run cursor in your terminal. If the command is missing:

1. Open command palette ⌘⇧P
2. Type install command
3. Select Install 'cursor' command (optionally install code command to override VS Code’s)

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.