Skip to main content

macOS

Mercury supports macOS 11 (Big Sur) and later, on both Apple Silicon (arm64) and Intel (x64).

curl -fsSL https://mercuryagent.sh/install.sh | sh

This downloads the latest binary for your CPU, verifies its SHA-256 against the published checksums.txt, and installs to ~/.mercury/bin/mercury. Your shell PATH is updated in ~/.zshrc (or ~/.bashrc if you use bash).

After install:

exec $SHELL -l   # reload PATH
mercury --version

Via npm (if you already have Node)​

npm i -g @cosmicstack/mercury-agent
mercury

Requires Node.js 20+. Install Node via nvm, Homebrew (brew install node@20), or the official installer.

Apple Silicon vs Intel​

The installer auto-selects:

CPUAsset
Apple Silicon (M1/M2/M3/M4)mercury-macos-arm64
Intelmercury-macos-x64

To verify which architecture your Mac uses:

uname -m   # arm64 or x86_64

Pinning a version​

curl -fsSL https://mercuryagent.sh/install.sh | MERCURY_VERSION=1.1.9 sh

Custom install location​

curl -fsSL https://mercuryagent.sh/install.sh | \
  MERCURY_INSTALL=/opt/mercury MERCURY_NO_PATH=1 sh

Add /opt/mercury/bin to your PATH manually.

Gatekeeper / "unidentified developer"​

The binary is currently unsigned. On first run macOS may quarantine it. Either:

xattr -d com.apple.quarantine ~/.mercury/bin/mercury

…or right-click the binary in Finder and choose Open to whitelist it once.

A signed/notarized build is on the roadmap.

Uninstall​

rm -rf ~/.mercury
# then remove the PATH line added to ~/.zshrc or ~/.bashrc

For npm installs:

npm uninstall -g @cosmicstack/mercury-agent

Next steps​