Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

1.9 KB
Raw Blame
---
id: macos
title: macOS
sidebar_label: macOS
---

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

## Quickest install (recommended)

```bash
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:

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

## Via npm (if you already have Node)

```bash
npm i -g @cosmicstack/mercury-agent
mercury
```

Requires **Node.js 22+**. Install Node via [nvm](https://github.com/nvm-sh/nvm), Homebrew (`brew install node@22`), or the official installer.

## Apple Silicon vs Intel

The installer auto-selects:

| CPU | Asset |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | `mercury-macos-arm64` |
| Intel | `mercury-macos-x64` |

To verify which architecture your Mac uses:

```bash
uname -m   # arm64 or x86_64
```

## Pinning a version

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

## Custom install location

```bash
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:

```bash
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

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

For npm installs:

```bash
npm uninstall -g @cosmicstack/mercury-agent
```

## Next steps

- [Setup](../setup) — configure your first provider
- [Starting Mercury](../starting)