Installation guide

Disable WSL interop

To prevent issues caused by having the Windows $PATH in the WSL environment, we can disable that functionality.

In particular, this solves a problem I had where the utils binary - when installing it on Windows - was loaded into $PATH before the utils binary from ~/.go/bin. This made it impossible to run the utils binary from ~/.go/bin because the Windows version was always loaded first.

To disable WSL interop, add the following to your /etc/wsl.conf file:

[interop]
appendWindowsPath = false

After restarting WSL , the Windows $PATH will no longer be appended to the WSL environment.

However, this also means that we cannot run Windows executables directly from WSL anymore. So for example, explorer.exe or running code to open Visual Studio Code directly from WSL will not work anymore.

To make this work again, those executables need to be added to the WSL $PATH manually using their full path.