Guides
Run Muse Code on Windows without WSL
Muse Code runs natively on Windows, so WSL2 is optional. Install the CLI on Windows, run muse login in PowerShell, and Helicon drives it directly with your own Windows paths and PowerShell for shell commands. If only a WSL2 install is present, Helicon routes there instead and translates paths both ways.
Last updated · Markdown version
Check which route you are on
Open PowerShell and ask the CLI directly. If it answers there, you have a native install and WSL2 is not involved.
muse --versionIf that fails but the same command answers inside your WSL2 shell, your install lives in the distribution and Helicon will route through it.
What native gives you
- Your own Windows paths, with no /mnt/c translation anywhere in the loop.
- PowerShell for shell commands, so your profile, aliases and tooling apply.
- No distribution to keep updated alongside Windows.
- Fewer moving parts when something goes wrong.
When to keep WSL2 anyway
- Your project lives inside the distribution and your toolchain is Linux.
- You depend on Linux only build steps the agent has to run.
- You set Muse Code up before native Windows support and it works.
Run Muse Code natively on Windows
Install the muse CLI on Windows. Use the Windows install path rather than installing inside a distribution.
Confirm PowerShell can see it. A version answer here means you are native.
muse --versionSign in. Authentication stays with the CLI.
muse loginInstall Helicon. Run the signed Windows installer from the latest GitHub release.
Add your project. Point Helicon at the Windows path you actually work in.
Frequently asked questions
Is WSL2 still supported?
Yes. Helicon uses Muse Code inside WSL2 when native Muse Code is not installed, and translates paths in both directions.
Can I have both installs?
You can, and Helicon will prefer the native one. Keeping both is a reasonable way to migrate gradually.
Which shell runs the agent's commands?
PowerShell on the native route, and the distribution's shell on the WSL2 route.
Keep reading
- WindowsA signed Windows installer for a Muse Code desktop app, with auto update. Runs Muse Code natively on Windows, or inside WSL2 with path translation both ways.
- WSL2If your muse CLI lives in WSL2 Ubuntu, Helicon routes to it from the Windows desktop app and translates paths both ways, so the agent and the UI agree on where files are.
- Windows developersA signed installer, native Windows Muse Code with PowerShell, and WSL2 path translation when you need it. The Windows setup tax, paid once by the app instead of by you.
Same Muse Code. Same subscription. Better interface.
Free and MIT licensed. Signed Windows installer, universal macOS DMG, and a web build against a daemon you run.