Issue connecting to repo through WSL

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

When working with WSL sometimes there seems to be an issue connecting to the WSL service. Sometimes this resolves itself in 30 seconds other times it just won’t connect. Typically this happen on startup after working on some code rewrites. You can see on the right that I don’t see my file structure in the file browser and I get a warning when trying to shut down

Steps to Reproduce

Run your code from WSL using Ubuntu. Work on the repo and then chut down cursor. This is one of those annoying intermittent issues. I’m not sure what triggers this.

Expected Behavior

You should see your file system and be able to save files. Note that if I go through the WSL desktop environment I’m able to log in and see my linux files through the command terminal.

Screenshots / Screen Recordings

Operating System

Windows 10/11
Linux

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.2.36 (system setup)
VSCode Version: 1.105.1
Commit: 55c9bc11e99cedd1fb93fbb7996abf779c583150
Date: 2025-12-18T06:25:21.733Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Windows_NT x64 10.0.26200

Does this stop you from using Cursor

Yes - Cursor is unusable

I’m wondering if there was any progress on this issue or if anyone was encountering similar issues. I do have the official WSL installed. Its probably an issue with this Anysphere version of the WSL extension?

Thanks for the report.

A few things to try:

  1. Update to the latest version (2.3.x is rolling out this week with stability improvements) via Cursor > Check for Updates
  2. Try restarting the WSL service from Windows: wsl --shutdown then reopen Cursor
  3. Check if the issue happens with a fresh WSL connection (close all Cursor windows, reopen and connect to WSL)

I’ve also raised this with the extensions team.

I have tried shutting down restarting, using the command prompt to shut down and clear any WSL related files for cursor.

Eventually it ends up working but it takes around 30 minutes to start up cursor if this starts acting up. Lots of restarts and then eventually it ends up connecting. It has nothing to do with WSL since I’m able to access my repo through WSL in explorer and through the WSL/Ubunto terminal. Its something related to how cursor connects to WSL.

I will check if 2.3 solves any of these issues. Its not available for download via early access. I don’t want to go with the nightly commits, since that might introduce some regressions.

1 Like

If anyone else is having this issue just start sursor with a windows based repo, uninstall WSL then reinstall it. Once that is done you can reopen your WSL based project.

That seems to do the trick. Otherwise you are going to waiting minutes potentially hours for this to work. Its very brittle and fidgety. The only thing that seems to work reliable is an uninstall and install.

1 Like

Thanks for sharing the workaround - that’s helpful for others experiencing this. I’ve passed this on to the extensions team. Please update to version 2.3 when it becomes available (should roll out soon) as it includes stability improvements that may help.

Following up on this. I upgraded to the latest version but the WSL is still very buggy. Its an issue each time I start and stop cursor so its becoming a real pain point

Another observation if anyone is having this issue. I noticed that things have improved with the latest update. I just need to wait for a while on startup before launching cursor. It seems that some background process might be blocking the connection and if it doesn’t catch initially then it just keeps trying to connect.

If you wait for windows to completely finish any startup tasks and then launch cursor that seems to work much better.