How to install Muse Code on macOS, Linux, and Windows (WSL2)

The “download” is one command

People search for a Muse Code download expecting a .dmg, an .exe, or an app-store page. There isn’t one. Muse Code is a command-line program, and the official way to get it is Meta’s install script:

curl -fsSL https://dev.meta.ai/install.sh | bash

The script puts a muse binary on your PATH; muse --version confirms it worked. If you’d rather not pipe a remote script straight into your shell, download it first with curl -fsSL https://dev.meta.ai/install.sh -o install.sh, read it, then run it. That is the whole download story on every supported platform — what changes is where you run it.

macOS and Linux

On a Mac or a Linux machine, open a terminal and run the command above. Two things are worth knowing before the first session:

• If muse isn’t found after the install, open a new terminal window so your shell re-reads its PATH.
• The first run signs you in. Running muse in a project directory opens your browser to authenticate at dev.meta.ai with a Meta developer account. Credentials are cached, so you won’t do it again every session. On servers, CI runners, and other headless machines, skip the browser: create a key in the Model API dashboard and export it as MODEL_API_KEY.

From there, cd into a git repository and run muse. Our getting-started guide suggests a good first task.

Windows: install it inside WSL2

There is no native Windows build. Meta’s installer targets macOS and Linux, and developers who try it from PowerShell report that it simply refuses to run. The working route is the Windows Subsystem for Linux, which gives you a real Linux environment on Windows 10 or 11:

1. Open PowerShell as an administrator and run wsl --install. This installs WSL2 with Ubuntu by default. Restart when prompted.
2. Launch Ubuntu from the Start menu and create your Linux user.
3. Make sure the basics are present: sudo apt update && sudo apt install -y curl git.
4. Run the Muse Code installer inside the Ubuntu terminal — the same curl … | bash line as above.
5. Keep your repositories in the Linux filesystem, for example ~/code, rather than under /mnt/c. Muse Code reads and writes a lot of files, and access across the Windows–Linux boundary is much slower.

If the browser sign-in doesn’t come up from inside WSL, use an API key instead: create one in the Model API dashboard and set MODEL_API_KEY in your Linux shell profile.

VS Code, JetBrains, and the “desktop app” question

Meta ships no desktop app, no IDE, and no official editor extension for Muse Code. That doesn’t mean you have to give up your editor:

• VS Code: run muse in the integrated terminal. On Windows, install Microsoft’s WSL extension, open your project folder in WSL, and the integrated terminal becomes a Linux shell where Muse Code works normally.
• Zed and JetBrains IDEs: community projects bridge Muse Code into editors that speak the Agent Client Protocol (ACP). They are unofficial — check what they send where before you point one at private code.

Be wary of anything advertised as a “Muse Code desktop app” or a “Muse Code for Windows” download. None of those are published by Meta; the install script above is the only official distribution.

Keeping it current

Meta’s documentation shows the installer and nothing else, so check muse --help for the commands your version supports, and follow our changelog for releases. Muse Code left beta on August 31, 2026, and switched to the Muse Spark 1.3 model two days later — an up-to-date install gets both.

Then pick how you’ll pay

Installing is free; using Muse Code is not. You can subscribe to a monthly plan — Everyday Usage at $5, High Usage at $15, or Power Usage at $50 — or skip the plan and pay per token through the Meta Model API. The pricing page compares both and includes a cost estimator.