Skip to main content

Windows

Mercury runs natively on Windows 10 (build 1809+) and Windows 11, on x64. Native arm64 binaries are not yet published — on Windows on ARM, use WSL or the npm route.

Open PowerShell (any version) and run:

irm https://mercuryagent.sh/install.ps1 | iex

This downloads mercury-win-x64.exe, verifies its SHA-256, installs it to %USERPROFILE%\.mercury\bin\mercury.exe, and prepends that directory to your user PATH. No admin required.

After install, open a new terminal window and run:

mercury --version
Execution policy

If PowerShell blocks the script, allow user scripts for the current session:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://mercuryagent.sh/install.ps1 | iex

Via npm (if you already have Node)​

npm i -g @cosmicstack/mercury-agent
mercury

Requires Node.js 20+. Install from nodejs.org or via winget install OpenJS.NodeJS.LTS.

Pinning a version​

$env:MERCURY_VERSION = '1.1.9'
irm https://mercuryagent.sh/install.ps1 | iex

Custom install location​

$env:MERCURY_INSTALL = 'C:\Tools\mercury'
$env:MERCURY_NO_PATH = '1'
irm https://mercuryagent.sh/install.ps1 | iex

Then add C:\Tools\mercury\bin to your PATH manually via System Properties → Environment Variables.

Mercury's TUI uses Unicode, true color, and ANSI escapes. For best results, use Windows Terminal (default on Windows 11, free from the Store on Windows 10). The legacy cmd.exe window may render box-drawing characters incorrectly.

WSL alternative​

If you prefer a Linux environment, install Mercury inside WSL2:

wsl --install -d Ubuntu
# inside WSL:
curl -fsSL https://mercuryagent.sh/install.sh | sh

Follow the Linux guide from there.

SmartScreen / antivirus​

The .exe is unsigned today. SmartScreen may show "Windows protected your PC" on first run — click More info → Run anyway. A code-signed build is on the roadmap.

Uninstall​

Remove-Item -Recurse -Force $env:USERPROFILE\.mercury

Then remove the entry from your user PATH (System Properties → Environment Variables).

For npm installs:

npm uninstall -g @cosmicstack/mercury-agent

Next steps​