Cursor in WSL2 on Windows

11 March 2025

Cursor in WSL2 on Windows is a pain: neither the latest version of Cursor nor the latest version of WSL extension will actually work. As such I cannot recommend this because it is so fiddly. With that disclaimer; this is how I got it working:

Using

Steps

  1. Install Cursor
  2. Run Cursor from within Windows, select Extensions, and drag and drop in ms-vscode-remote.remote-wsl-0.88.3.vsix, which will install the extension
  3. Close Cursor in Windows
  4. Within WSL, run /mnt/c/Users/$WIN_USERNAME/AppData/Local/Programs/cursor/resources/app/bin/cursor to launch Cursor, where $WIN_USERNAME is your username in Windows

Cursor should then open in Windows and connect to the WSL environment

Further

The Cursor Extensions tab doesn’t seem to work in WSL so any extensions need to be downloaded manually and dropped in e.g. https://marketplace.visualstudio.com/_apis/public/gallery/publishers/vscodevim/vsextensions/vim/1.29.0/vspackage for Vim keybindings


  1. By WSL I mean the latest version of WSL, being WSL2, so here I use WSL and WSL2 interchangeably. For more on WSL and its versions see Microsoft documentation here.