Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
website: Mercury Desktop first — download for this computer, /download, desktop docs, 1.5.0 notes
Salman Qureshid6d4e6362923
diff --git a/website/blog/2026-11-03-mercury-1-5/cover.jpg b/website/blog/2026-11-03-mercury-1-5/cover.jpgnew file mode 100644index 00000000..fb8bdd52Binary files /dev/null and b/website/blog/2026-11-03-mercury-1-5/cover.jpg differdiff --git a/website/blog/2026-11-03-mercury-1-5/index.md b/website/blog/2026-11-03-mercury-1-5/index.mdnew file mode 100644index 00000000..65c38ab1--- /dev/null+++ b/website/blog/2026-11-03-mercury-1-5/index.md@@ -0,0 +1,61 @@+---+slug: mercury-1-5+title: "Mercury 1.5: Mercury Desktop"+description: "Mercury 1.5.0 ships Mercury Desktop for macOS, Windows and Linux, remote access the owner approves, and updates that roll back on their own."+authors: [mercury-eng]+tags: [news, releases]+image: ./cover.jpg+keywords: [mercury desktop, mercury 1.5, ai agent desktop app, self-hosted ai agent, remote access, auto update rollback]+draft: false+---++Mercury 1.5.0 is out, and with it Mercury Desktop: an app for macOS (Apple Silicon and Intel), Windows and Linux. It installs Mercury on your computer without a terminal, or connects to a Mercury you already run on a server. The same release changes how other devices reach your Mercury, and how both the app and the runtime update themselves.++[Download Mercury Desktop](/download), or read the [release notes](/docs/releases/1.5.0).++{/* truncate */}++## The app++The first screen looks for Mercury on your computer. If it finds one, it connects. If it doesn't, **Install Mercury here** downloads the release for your machine, checks it against the release's SHA-256 checksums, and runs it as a service. **Connect elsewhere** adds a Mercury on another machine, and you can keep several connections and switch between them.++Inside are chat, a coding workspace per project, research with live progress, bots and their results inbox, and notifications when something needs you. [Install & first run](/docs/desktop/mercury-desktop) covers the details.++One honest caveat: this first release isn't code-signed with an Apple or Windows certificate. macOS and Windows ask once before the first launch, and the [download page](/download) shows the clicks. Updates are a different matter. Each one is signed with Mercury's update key and checked before it installs.++## Other devices now need your approval++An app that connects to a Mercury somewhere else made us look hard at how remote access worked, and it wasn't good enough. Mercury listens only on `127.0.0.1`, so a remote device reaches it through a tunnel or proxy on the same machine. Those connect from `127.0.0.1` too, and several "this computer only" checks trusted that address. Through a tunnel, a device with a token could do what you can do at the keyboard, including open a shell.++In 1.5.0, a request counts as local only when it comes from `127.0.0.1` with no proxy headers and a `localhost` host. Everything else is remote, and remote devices work under your rules:++- A new device needs your approval. It shows a 5-character code, and you answer `approve K7Q2M` from Telegram or WhatsApp, from the terminal, or in Mercury Desktop on your computer.+- Sensitive actions from a remote device ask you each time: the terminal (off for remote devices unless you turn it on), Allow All, the workspace folder, powerful bots, plugins, channel tokens, restarts and the password.+- Devices unused for 30 days are signed out, revoking one cuts its open connections, and a device connecting from a new address tells you.++`/server` in the terminal, or `mercury server` in a shell, manages all of it, and `mercury doctor --security` checks your setup. The design is in [ADR-035](https://github.com/cosmicstack-labs/mercury-agent/blob/main/DECISIONS.md), and [Remote access & security](/docs/desktop/remote-access) explains how to use it.++## Updates that put things back++Updating used to mean `mercury upgrade`, which removed the npm package before installing the new one, kept no backup, and didn't check that the new version started. Now an update, from the app or the terminal, does this:++1. Waits for running work to finish, for up to 10 minutes.+2. Downloads the new version, resuming if the connection drops, and checks its checksums.+3. Backs up the current program and Mercury's settings.+4. Stops Mercury, installs, starts it, and waits for it to answer as the new version.+5. If it doesn't, puts the old version and settings back and starts that.++We ran this for real on a test install before the release. Updating 1.4.1 to the published 1.4.2 worked and Mercury was back in about four seconds. The first attempt, though, rolled back: the 1.4.2 binary reports an empty version on its health endpoint, so the check never matched. The updater now asks the installed program for its version when that happens. A deliberately broken release also kept Mercury offline for the full 90-second wait, so the updater now notices a crashed start and rolls back in about 15 seconds.++Mercury Desktop shows an Update button at the top right, like Chrome's. It gets more noticeable the longer an update waits, and one panel covers the app and every server it connects to. You can read what's new before you update. When an update has to happen, for a security fix, the app says so on a screen you can only get past by ticking a short checklist, and only for a while. [Updating Mercury](/docs/desktop/updating) has the whole picture.++## Also in 1.5.0++- **Research you can watch.** A plan you can edit, every source read or failed with the reason, and a report even when a run is cut short. Reports export as PDF or Word.+- **Files in one place.** What Mercury makes goes in `~/mercury-artifacts`, one folder per chat.+- **MCP servers.** Mercury can use tools from Model Context Protocol servers, and every MCP call asks first in Ask Me mode. See [MCP Servers](/docs/integrations/mcp).+- **Bots 2.0.** Each run reports, says there was nothing new, or says it failed, and results wait in an inbox.++Update with `mercury upgrade`, or [download Mercury Desktop](/download) and let it update your Mercury for you.++https://github.com/cosmicstack-labs/mercury-agentdiff --git a/website/docs/desktop/mercury-desktop.mdx b/website/docs/desktop/mercury-desktop.mdxnew file mode 100644index 00000000..0f6a9b0c--- /dev/null+++ b/website/docs/desktop/mercury-desktop.mdx@@ -0,0 +1,94 @@+---+id: mercury-desktop+title: "Mercury Desktop"+sidebar_label: "Install & first run"+description: "Install Mercury Desktop on macOS, Windows or Linux, open it the first time, and run Mercury on this computer or connect to one elsewhere."+keywords: [mercury desktop, download, install, macos, windows, linux, tauri, remote, devices]+---++# Mercury Desktop++Mercury Desktop is the app for Mercury. It can install Mercury on your computer for you, or connect to a Mercury you already run on a server, a home machine or Mercury Cloud. One app can hold several connections at once.++It runs on macOS (Apple Silicon and Intel, macOS 11 or newer), Windows 10 and 11 (x64) and Linux (x64).++## Download++Get it from the [download page](/download). It picks the right build for your computer. Every build is also on [GitHub Releases](https://github.com/cosmicstack-labs/mercury-agent/releases).++| Computer | File |+|---|---|+| Mac with Apple Silicon (M1 and newer) | `Mercury_<version>_aarch64.dmg` |+| Mac with an Intel chip | `Mercury_<version>_x64.dmg` |+| Windows | `Mercury_<version>_x64-setup.exe` (or the `.msi` for managed installs) |+| Linux | `Mercury_<version>_amd64.AppImage`, `.deb` or `.rpm` |++## Opening it the first time++Mercury Desktop 1.5.0 isn't code-signed with an Apple or Windows certificate yet, so your computer asks once before it opens it. Signing is coming in a later release. Updates are different: every update is signed with Mercury's update key and checked before it installs (see [Updating Mercury](/docs/desktop/updating)).++### macOS++1. Open the `.dmg` and drag **Mercury** to **Applications**.+2. Open Mercury. macOS says "Apple could not verify Mercury is free of malware". Click **Done**.+3. Open **System Settings → Privacy & Security**. Under **Security**, click **Open Anyway** next to Mercury, then confirm with your password.++On older macOS versions you can right-click Mercury in Applications and choose **Open** instead.++If macOS says Mercury "is damaged and can't be opened", clear the download flag and open it again:++```bash+xattr -dr com.apple.quarantine /Applications/Mercury.app+```++### Windows++1. Run `Mercury_<version>_x64-setup.exe`.+2. If Microsoft Defender SmartScreen shows "Windows protected your PC", click **More info**, then **Run anyway**.++### Linux++```bash+# AppImage: any distribution+chmod +x Mercury_*_amd64.AppImage+./Mercury_*_amd64.AppImage++# Debian / Ubuntu+sudo apt install ./Mercury_*_amd64.deb++# Fedora / openSUSE+sudo dnf install ./Mercury-*.x86_64.rpm+```++## First run: where should Mercury run?++The first screen checks this computer for a running Mercury and offers three ways in.++- **Use the Mercury here.** Mercury is already installed on this computer. If it's running, the app connects. If it's stopped, **Start Mercury** starts it. If it's too old for the app, **Update Mercury** updates it first.+- **Install Mercury here.** The app downloads the Mercury release for your computer, checks its SHA-256 against the release's `checksums.txt`, installs it to `~/.mercury/bin` and runs it as a service. You don't need a terminal. Then it walks you through choosing a model.+- **Connect elsewhere.** Mercury runs on another machine: a server, a home computer, a phone on Termux, or Mercury Cloud.++On this computer the app signs in with Mercury's local attach token, so there is nothing to type.++## Connecting to a Mercury elsewhere++You need the address the other Mercury is reachable at, usually through a tunnel such as Tailscale or Cloudflare Tunnel (Mercury itself only listens on `127.0.0.1`). Then choose one of two ways to sign in:++- **Sign in** with that Mercury's dashboard username and password. The owner of that Mercury has to approve this device. The app shows "Waiting for the owner to approve this device" and a 5-character code. The owner approves it from Telegram or WhatsApp (`approve K7Q2M`), from `/server` or `mercury server approve K7Q2M` on that computer, or in Mercury Desktop on that computer. Nobody answering within 10 minutes means no.+- **Device token.** The owner makes a token on that computer with `/server token <name>` (or `mercury devices add "<name>"`) and gives it to you. It starts with `mdt_` and is shown once.++The app keeps each connection's credentials in your system keychain. Removing a connection in **Settings → Connections** also revokes its token on that Mercury.++See [Remote access & security](/docs/desktop/remote-access) for what an approved device can and can't do, and how the owner controls it.++## Several servers++Add as many connections as you like and switch between them from the top bar. The app checks every connection for updates, not just the one you're using, and shows each in its updates panel (see [Updating Mercury](/docs/desktop/updating)).++## What else is in the app++- **Chat and Code.** Conversations, and a coding workspace per project.+- **Research.** A research bar with live progress, sources read and failed with reasons, and a report you can export as PDF or Word.+- **Bots.** Create and run bots, and read their results in one inbox.+- **Notifications** when a reply, a research run or a bot needs you.+- **Settings → About** shows the app's and every server's version and has **Check for updates**.diff --git a/website/docs/desktop/remote-access.mdx b/website/docs/desktop/remote-access.mdxnew file mode 100644index 00000000..f1e1005c--- /dev/null+++ b/website/docs/desktop/remote-access.mdx@@ -0,0 +1,108 @@+---+id: remote-access+title: "Remote access & security"+sidebar_label: "Remote access & security"+description: "Let other devices use your Mercury safely: owner approvals for new devices and sensitive actions, device tokens and their lifecycle, allowed addresses, /server and mercury doctor --security."+keywords: [mercury remote access, device token, owner approval, tunnel, tailscale, cloudflare tunnel, security, allowed ips]+---++# Remote access & security++Mercury only listens on `127.0.0.1`. To use it from another device (Mercury Desktop on your laptop, the web dashboard from your phone), you put a tunnel or proxy in front of it, such as Tailscale or Cloudflare Tunnel. Mercury treats anything that arrives that way as remote, even when the tunnel runs on the same machine.++You stay in control: a new device needs your approval, and a remote device has to ask you before it does anything that could take over your Mercury.++## What counts as "this computer"++A request is from this computer only when it comes from `127.0.0.1` **and** carries no proxy or tunnel header (`Forwarded`, `X-Forwarded-*`, `X-Real-IP`, `CF-Connecting-IP`, `Tailscale-*` and similar) **and** names `localhost` as its host. Mercury Desktop and the terminal on this computer use Mercury's local attach token, which is never accepted through a tunnel.++A request straight to this machine that names some other host is refused, which blocks DNS-rebinding attacks. If you run Mercury behind your own proxy on another name, add that name to `web.allowedHosts` in `mercury.yaml`.++## Owner approvals++When a remote device needs your permission, Mercury asks you with a 5-character code. You answer once, from any of these:++- **Telegram, WhatsApp or another connected chat:** reply `approve K7Q2M` or `deny K7Q2M`. Only an admin of that chat can answer.+- **The terminal on this computer:** `/server approve K7Q2M` in chat, or `mercury server approve K7Q2M` in a shell.+- **Mercury Desktop on this computer:** Approve or Deny on the card it shows.++The device that asked can never answer its own question. Nobody answering within 10 minutes means no.++### New devices++Signing in from another device with the dashboard password doesn't give it access straight away. The device shows "Waiting for the owner to approve this device" and the code, and gets its token once you approve. Signing in from this computer needs no approval.++### Sensitive actions++An approved device can chat, run things under your current permission mode and read results. These need your approval each time:++- the terminal (and it's off entirely for remote devices unless you turn it on);+- changing the workspace folder, turning Allow All on, or changing the permissions file;+- operator or full-access bots, raw bot permissions and bot imports;+- installing skills from a URL, and plugins;+- channel settings and tokens, letting someone into a channel or making them an admin, Signal linking;+- Mercury Cloud sign-in, and changing a provider's server address without a new key;+- restarting Mercury, changing the password or username, and revoking another device;+- a board's working folder;+- starting a server update.++Mercury Cloud asks you the same way before it turns Allow All on or installs a skill. If a device repeats a request while your answer is pending, Mercury doesn't ask you again.++## Devices and their tokens++Each approved device gets a device token (`mdt_…`) that Mercury Desktop keeps in the system keychain.++- **Expiry.** A device not used for 30 days is signed out and needs your approval again.+- **Limit.** 10 devices at most. Mercury checks the limit before it asks you.+- **New location.** When a known device connects from an address it hasn't used before, Mercury tells you.+- **Revoke.** Revoking a device cuts its open connections at once.+- **Password change.** Changing the dashboard password signs out every other browser, and can sign out all devices too.++To make a token by hand for a device that can't sign in itself, run `/server token <name>` (or `mercury devices add "<name>"`) on this computer. It's shown once.++## /server and mercury server++`/server` in the terminal chat opens a menu for remote access. It works only on the computer Mercury runs on: in the terminal, an attached terminal, or Mercury Desktop there. `mercury server` gives the same commands from a shell.++```text+/server open the menu+/server status what can connect, and how+/server on | off allow or refuse other devices+/server approve <code> let a waiting device or action through (deny <code> to refuse)+/server devices paired devices · /server revoke <id|name> · /server revoke-all+/server token <name> make a token for a device by hand (shown once)+/server allow-ip <ip|range> · remove-ip <ip|range> · allow-any+/server shell on|off the terminal for remote devices (each command still asks you)+/server expire <days>|never · /server limit <n>+/server check the security check · /server log the security log+```++The settings live in `~/.mercury/remote.json` and apply at once:++| Setting | Default | Meaning |+|---|---|---|+| `enabled` | `true` | Other devices may connect. `/server off` refuses them all. |+| `allowIps` | empty (any) | Addresses or CIDR ranges allowed to connect. |+| `allowShell` | `false` | Whether remote devices get a terminal. Each command still asks you. |+| `maxDevices` | `10` | How many devices can be paired. |+| `idleDays` | `30` | Days unused before a device is signed out. |++### Allowed addresses++With an address list set, Mercury refuses any client whose address isn't on it. It needs a tunnel that passes the real client address (Tailscale and Cloudflare do). If the tunnel hides it, Mercury refuses the client rather than guessing, and `/server` warns you.++## The security check++```bash+mercury doctor --security+```++It checks the dashboard password, devices, file permissions on Mercury's secrets and how your tunnel forwards requests. Every `mercury doctor` run shows a one-line summary of it, and `/server check` shows the same findings.++The security log, `~/.mercury/security/audit.jsonl`, records failed and locked sign-ins, pairings, approvals and refusals, revocations, expired devices, new locations, blocked requests, password and setting changes, and started updates. `/server log` shows the latest entries.++## Things to know++- **A proxy without forwarding headers looks local.** If you put Mercury behind your own proxy (plain nginx, for example), make it send `X-Forwarded-For` and keep the original host. A proxy that sends neither and rewrites the host to `localhost` makes remote requests look local. The attach token still protects the most sensitive operations, and the security check flags it.+- **An approved device is trusted like you while it's paired.** It answers its own Ask Me prompts and runs things under your permission mode. Revoke a device you no longer use.+- **Keep the tunnel private if you can.** A Tailscale tailnet, or Cloudflare Access in front of a Cloudflare Tunnel, means only your devices can reach the sign-in page at all.diff --git a/website/docs/desktop/updating.mdx b/website/docs/desktop/updating.mdxnew file mode 100644index 00000000..93527711--- /dev/null+++ b/website/docs/desktop/updating.mdx@@ -0,0 +1,124 @@+---+id: updating+title: "Updating Mercury"+sidebar_label: "Updating"+description: "How Mercury Desktop and the Mercury runtime update: the Update button, resumable signed downloads, server updates with automatic rollback, required updates and messages."+keywords: [mercury update, mercury upgrade, auto update, rollback, desktop update, required update]+---++# Updating Mercury++There are two things to keep current: **Mercury Desktop** (the app) and **Mercury** itself (the runtime, on this computer or on a server). Both update the same careful way: download in the background, check the download, install, and confirm the new version works. If it doesn't, they put the old version back.++Nothing pops up uninvited. The one exception is an update marked as required, described [below](#required-updates).++## How Mercury knows what's new++Mercury publishes one update notice at `https://mercuryagent.sh/updates/manifest.json`. It lists the newest versions with their release notes, the oldest version still supported, and any message for people running Mercury. The notice is signed. Mercury and Mercury Desktop ignore a notice whose signature doesn't check out, and an older notice than one they've already seen.++If the notice can't be fetched (you're offline, a firewall blocks it), nothing is blocked. Mercury falls back to asking GitHub or npm for the newest version and keeps working.++Mercury checks at most every 6 hours. **Check for updates** asks right away.++## Mercury Desktop++### The Update button++When something can be updated, an **Update** button appears at the top right of the window, like Chrome's. It covers the app and every server the app connects to. Its colour rises the longer an update waits:++| Waiting | Colour |+|---|---|+| Under 2 days | Grey |+| 2 to 4 days | Accent |+| 4 to 7 days | Amber |+| 7 days or more | Red |++A security update is red from the start. A required update reads **Update required** and can't be hidden.++### The updates panel++Click the button to open the panel. It has a row for Mercury Desktop and one for each server with an update:++- the version you have and the new one, with **What's new** to read the notes before you update;+- the action: **Download**, **Restart to update**, or **Update server**;+- live progress: bytes, speed, time left and the current step;+- **Later**, which hides that update for 24 hours.++When more than one thing can be updated, **Update all** updates them together.++### Downloads++With **Download updates automatically** on (the default), the app downloads a new version in the background. Nothing installs until you restart.++- A dropped connection doesn't start the download over. The app resumes from the bytes it has, even after you quit and reopen it.+- The app waits up to 30 seconds for data before it reconnects, and tries up to 5 times.+- **Cancel** stops a download and keeps what it has. **Resume download** continues from there.+- A download only counts as ready after its signature checks out. One that doesn't match is deleted, so the next try starts clean.++### Installing++- **Restart to update** installs the update and reopens the app. If a reply is still coming in, the app asks first. The reply keeps running on the server and is there when the app is back.+- **Install a downloaded update when I quit** (on by default) installs it the next time you quit, so the next start is the new version.++If an update fails 3 times, the app stops retrying that version and offers **Download from website** instead.++### Check for updates++**Settings → About** has **Check for updates**. It checks Mercury Desktop and every server you connect to in one go, then says either "Everything is up to date" or what it found. **Update everything** then updates each server that can update itself and restarts the app last, once the servers are done. The tray menu has **Check for Updates…** too.++## Mercury on a server++### From Mercury Desktop++A server's row in the updates panel has **Update server**. From a device other than that server's own computer, the owner approves the update first (the same 5-character code as [new devices](/docs/desktop/remote-access#owner-approvals)). The panel follows the update through the server's restart and reconnects when it's back.++### From the command line++```bash+mercury update # what's new, and whether an update is required+mercury update check # ask again now+mercury upgrade --check # the same, from upgrade+mercury upgrade # update to the newest version+mercury upgrade --now # don't wait for running work+mercury upgrade --force # reinstall even when already on the newest version+```++With Mercury running, `mercury upgrade` asks the running Mercury to do the update, so it can wait for running work and come back as the new version. With Mercury stopped, the command does every step itself and leaves Mercury stopped.++### What a server update does++1. **Waits for running work.** A reply, a queued message or a bot run finishes first, for up to 10 minutes. **Update now without waiting** in the app (or `--now`) skips the wait.+2. **Downloads** the new version, resuming if the connection drops, and checks it against the release's SHA-256 checksums. An npm install fetches the exact version into npm's cache.+3. **Backs up** the current program and Mercury's settings files in `~/.mercury`.+4. **Stops Mercury, installs the new version and starts it.**+5. **Checks it works.** The new version must answer as the new version within 90 seconds.+6. **If it doesn't, rolls back.** Mercury puts the old program and settings back and starts the old version. If the new version crashes on start, this happens in about 15 seconds.++Mercury is offline only between steps 4 and 6, usually a few seconds.++If a release is announced but its files aren't published yet, the update stops before anything changes and says to try again later. That doesn't count as a failure. If an update to one version really fails 3 times, Mercury stops offering it on its own. `mercury upgrade` still tries, and shows what went wrong.++A Mercury running from a source checkout doesn't update itself. Update it with `git pull` and a build.++## Required updates++Sometimes a version has to go, usually for a security fix. The update notice then names the oldest supported version and says why.++**Mercury Desktop** shows a full-screen notice that Escape and clicking outside don't close. It explains the reason and has **Update now** with live progress. You can still minimise the window. **Continue without updating** asks you to tick every box first:++- I understand this version has a known problem that the update fixes.+- Mercury may stop working with my servers or some features until I update.+- I'm responsible for anything exposed while I stay on this version.+- I'll update as soon as I can.++That lasts until the app restarts or for 24 hours, whichever comes first, and the top-right button stays red meanwhile. The same screen appears when the server the window is connected to is below its required version. If you can't update that server yourself, it says what the owner has to run.++**On a server**, a required update shows in the terminal every time Mercury starts, in `mercury doctor` and in `mercury update`, and `/update ignore` can't silence it.++## What's new++After Mercury Desktop or a server you connect to moves to a newer version, the app shows a toast once: "Mercury Desktop updated to 1.5.0 · What's new". It opens the release notes. **Settings → About → What's new** opens them again. In the terminal, `/whatsnew` shows the notes for the version you run.++## Messages++The update notice can carry a short message for people on certain versions. Mercury Desktop shows an information message once as a toast, and a warning or critical one as a banner under the top bar. You can dismiss a message, except a critical one marked as permanent. The terminal shows each message once when Mercury starts.diff --git a/website/docs/getting-started/installation.mdx b/website/docs/getting-started/installation.mdxindex 664f2eab..2a46130e 100644--- a/website/docs/getting-started/installation.mdx+++ b/website/docs/getting-started/installation.mdx@@ -6,6 +6,12 @@ slug: /Mercury runs anywhere Node.js 22+ runs, plus everywhere a single binary can live — including phones via Termux.+## The easiest way: Mercury Desktop++On a Mac, Windows or Linux computer, [download Mercury Desktop](/download). It installs Mercury for you, with no terminal, and keeps it updated. It can also connect to a Mercury on another machine. See [Install & first run](/docs/desktop/mercury-desktop).++The rest of this page installs the Mercury runtime from the command line: for servers, headless machines, Termux, or if you prefer the terminal.+## Pick your platform- **[macOS](/docs/getting-started/platforms/macos)** — `curl | sh` installer, Homebrew-style PATH setup, Apple Silicon & Intel binaries.diff --git a/website/docs/releases/1.5.0.mdx b/website/docs/releases/1.5.0.mdxnew file mode 100644index 00000000..08a80a03--- /dev/null+++ b/website/docs/releases/1.5.0.mdx@@ -0,0 +1,72 @@+---+title: "v1.5.0 — Mercury Desktop"+sidebar_label: "v1.5.0"+description: "Mercury Desktop for macOS, Windows and Linux; remote access the owner controls; updates that roll back on their own; research you can watch; MCP servers; Bots 2.0."+keywords: [mercury, mercury-agent, release, 1.5.0, mercury desktop, remote access, updates, research, mcp, bots]+---++import Head from '@docusaurus/Head';++<Head>+ <meta property="og:title" content="Mercury Agent v1.5.0 — Mercury Desktop" />+ <meta property="og:description" content="Mercury Desktop for macOS, Windows and Linux · Remote access the owner controls · Updates that roll back on their own · Research you can watch · MCP servers" />+ <meta property="og:type" content="article" />+ <meta property="og:url" content="https://mercuryagent.sh/docs/releases/1.5.0" />+ <meta name="twitter:card" content="summary_large_image" />+ <meta name="twitter:title" content="Mercury Agent v1.5.0 — Mercury Desktop" />+ <link rel="canonical" href="https://mercuryagent.sh/docs/releases/1.5.0" />+</Head>++# v1.5.0 — Mercury Desktop++> **Mercury gets an app.**++`1.5.0` ships **Mercury Desktop** for macOS (Apple Silicon and Intel), Windows and Linux, at the same version as the runtime. It installs Mercury on your computer without a terminal, or connects to Mercury on a server, and it keeps both up to date. [Download it](/download).++## Mercury Desktop++- **Install or connect.** The first screen finds a Mercury on this computer, installs one (the release is checked against its SHA-256 checksums and runs as a service), or connects to Mercury elsewhere. Several connections at once. See [Install & first run](/docs/desktop/mercury-desktop).+- **Not code-signed yet.** macOS and Windows ask once before the first launch. The [download page](/download) has the steps. Updates are signed and checked before they install.++## Remote access the owner controls++- **Tunnels are remote.** Requests through Tailscale, Cloudflare or a proxy are no longer treated as coming from this computer, even when the tunnel runs on the same machine.+- **New devices need your approval**, with a 5-character code you answer from Telegram, WhatsApp, the terminal or Mercury Desktop on this computer.+- **Sensitive actions from a remote device ask you first:** the terminal (off for remote devices by default), Allow All, the workspace folder, powerful bots, plugins and skills from a URL, channel tokens, Cloud sign-in, restarts and the password.+- **Device lifecycle:** devices unused for 30 days are signed out, 10 devices at most, a new address tells you, revoking cuts open connections.+- **`/server`, `mercury server` and `mercury doctor --security`.** Plus a sign-in attempt limit, CSRF and DNS-rebinding protection, and a security log.++See [Remote access & security](/docs/desktop/remote-access).++## Updates that never leave you broken++- **One signed update notice** says what's new, what's required and anything Mercury needs to tell you. An unsigned or older notice is ignored, and being offline never blocks anything.+- **Server updates** wait for running work, download with checksums, back up, install, confirm the new version answers, and roll back on their own if it doesn't. `mercury upgrade` uses the same steps.+- **Mercury Desktop** has a Chrome-style Update button, an updates panel for the app and every server, resumable signed downloads, **Check for updates** and **Update everything**.+- **Required updates** get a full-screen notice that only a ticked checklist gets past, for a while.++See [Updating Mercury](/docs/desktop/updating).++## Research you can watch++Research is one visible run: a plan you can edit, live progress, every source read or failed with the reason, and a report even when a run is cut short. Reports are saved to `~/mercury-artifacts/Research` and export as PDF or Word.++## Files in one place++What Mercury makes goes in `~/mercury-artifacts`, one folder per chat, instead of loose files in your home folder.++## MCP servers++Mercury can use tools from Model Context Protocol servers. Add one with `mercury mcp add`, allow the tools you want, and every MCP call asks first in Ask Me mode. See [MCP Servers](/docs/integrations/mcp).++## Bots 2.0++Every bot run ends by reporting, saying there was nothing new, or saying it failed. Results wait in an inbox until you read them. Waste is capped by rule: a minimum gap between routine runs, tools by group, and a routine that keeps failing switches itself off.++## Upgrading++```bash+mercury upgrade+```++Or download [Mercury Desktop](/download) and choose **Use the Mercury here**: it offers to update an older Mercury first.diff --git a/website/docs/releases/releases.mdx b/website/docs/releases/releases.mdxindex fc8d342d..8d675f82 100644--- a/website/docs/releases/releases.mdx+++ b/website/docs/releases/releases.mdx@@ -9,6 +9,7 @@ This section tracks Mercury release notes by version.## Available release notes+- [**v1.5.0 — Mercury Desktop**](/docs/releases/1.5.0) — Mercury Desktop for macOS, Windows and Linux; remote access the owner controls; updates that roll back on their own; research you can watch; MCP servers; Bots 2.0.- [**v1.4.0 — Pluggy Mercury**](/docs/releases/1.4.0) — The plugin system, WhatsApp chat and voice calls in both directions, and Optimus: Mercury uses your computer, by chat or out loud. Plus built-in web search, photos, PDFs and voice notes from chat.- [**v1.3.1 — Steady Mercury**](/docs/releases/1.3.1) — One runtime, instant attach, bots that do work and stay online, fleets with typed tasks and pipelines, Telegram control with buttons and files, Node 22 and a patched Ink 8 — plus the whole "Honest Mercury" line.- [**v1.3.0 — Mercury Bots**](/docs/releases/1.3.0) — Mercury becomes a fleet: persistent persona-scoped bots with private sandboxes and durable queues, lead bots that recruit their own crews, portable bundles, a web cockpit, and honest failure observability.diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.tsindex b4ba7605..cc5e4299 100644--- a/website/docusaurus.config.ts+++ b/website/docusaurus.config.ts@@ -135,8 +135,8 @@ const config: Config = {},// Bump with every release, together with RELEASE in src/components/Home/data.ts.announcementBar: {- id: 'release-1-4-0',- content: '☿ Mercury 1.4.0, <strong>Pluggy Mercury</strong>, is out: plugins, WhatsApp voice calls, and Optimus, which uses your computer. <a href="/docs/releases/1.4.0">Read the release notes →</a>',+ id: 'release-1-5-0',+ content: '☿ Mercury 1.5.0 is out with <strong>Mercury Desktop</strong> for macOS, Windows and Linux, remote access you control, and updates that roll back on their own. <a href="/download">Download it →</a>',isCloseable: true,},navbar: {@@ -161,7 +161,7 @@ const config: Config = {className: 'navbar-github','aria-label': 'Mercury Agent on GitHub',},- {to: '/#install', label: 'Install', position: 'right', className: 'navbar-cta'},+ {to: '/download', label: 'Download', position: 'right', className: 'navbar-cta'},],},footer: {@@ -170,7 +170,8 @@ const config: Config = {{title: 'Product',items: [- {label: 'Install', to: '/#install'},+ {label: 'Download', to: '/download'},+ {label: 'Install on a server', to: '/#install'},{label: 'Mercury Code', to: '/docs/integrations/coding-workspace'},{label: 'Mercury Bots', to: '/docs/integrations/mercury-bots'},{label: 'Mercury Cloud', to: '/cloud'},diff --git a/website/plugins/llms-txt.cjs b/website/plugins/llms-txt.cjsindex e4c266d5..b934a2b9 100644--- a/website/plugins/llms-txt.cjs+++ b/website/plugins/llms-txt.cjs@@ -90,11 +90,16 @@ module.exports = function llmsTxtPlugin(context) {'','> Mercury is an open-source, soul-driven AI agent that runs on your own machine. It reaches you from the terminal, Telegram, Discord, Slack, Signal and a local web dashboard, keeps a local long-term memory, asks before it acts through a permission system, stays inside a daily token budget, and keeps running as a background service. It ships Mercury Code (a coding environment) and Mercury Bots (persistent specialist agents).','',+ `Desktop app: Mercury Desktop for macOS (Apple Silicon and Intel), Windows and Linux at ${SITE}/download. It installs Mercury on the computer or connects to one elsewhere, and keeps both updated.`,+ '',`Install: \`curl -fsSL ${SITE}/install.sh | sh\` (macOS/Linux), \`irm ${SITE}/install.ps1 | iex\` (Windows), or \`npm i -g @cosmicstack/mercury-agent\` on Node.js 22+. Source: https://github.com/cosmicstack-labs/mercury-agent (MIT).`,'','## Docs','',`- [Getting started](${SITE}/docs): install, first run, channels`,+ `- [Mercury Desktop](${SITE}/docs/desktop/mercury-desktop): install the app, first run, connecting to a remote Mercury`,+ `- [Updating Mercury](${SITE}/docs/desktop/updating): desktop and server updates, rollback, required updates`,+ `- [Remote access & security](${SITE}/docs/desktop/remote-access): owner approvals, device tokens, /server`,`- [CLI commands](${SITE}/docs/cli-commands/cli-commands): every \`mercury\` command`,`- [Permissions model](${SITE}/docs/reference/permissions): scopes, approvals, blocklist`,`- [Second Brain memory](${SITE}/docs/reference/second-brain): how memory is extracted and recalled`,diff --git a/website/sidebars.ts b/website/sidebars.tsindex 29607cb2..e90c6061 100644--- a/website/sidebars.ts+++ b/website/sidebars.ts@@ -3,6 +3,16 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';const sidebars: SidebarsConfig = {docsSidebar: ['getting-started/installation',+ {+ type: 'category',+ label: 'Mercury Desktop',+ collapsed: false,+ items: [+ 'desktop/mercury-desktop',+ 'desktop/updating',+ 'desktop/remote-access',+ ],+ },{type: 'category',label: 'Platforms',@@ -84,6 +94,7 @@ const sidebars: SidebarsConfig = {collapsed: false,items: ['releases/releases',+ 'releases/1.5.0','releases/1.4.0','releases/1.3.1','releases/1.3.0',diff --git a/website/src/components/Download/DesktopDownload.tsx b/website/src/components/Download/DesktopDownload.tsxnew file mode 100644index 00000000..cf698668--- /dev/null+++ b/website/src/components/Download/DesktopDownload.tsx@@ -0,0 +1,111 @@+import React, { useEffect, useState } from 'react';+import Link from '@docusaurus/Link';+import clsx from 'clsx';+import { detect, UNKNOWN, type Detected } from './detect';+import { asset, sizeOf, DESKTOP, GITHUB_RELEASES, type AssetKey } from './release';++interface Choice { key: AssetKey; label: string }++/** The one button for this computer, and the other links worth offering beside it. */+function choicesFor(d: Detected): { primary: Choice | null; also: Choice[] } {+ const ok = (c: Choice) => asset(c.key) !== null;+ const pick = (list: Choice[]) => {+ const avail = list.filter(ok);+ return { primary: avail[0] ?? null, also: avail.slice(1) };+ };+ const silicon: Choice = { key: 'macos-arm64', label: 'for macOS (Apple Silicon)' };+ const intel: Choice = { key: 'macos-x64', label: 'for macOS (Intel)' };+ switch (d.os) {+ case 'macos':+ return pick(d.appleSilicon === false ? [intel, silicon] : [silicon, intel]);+ case 'windows':+ return pick([{ key: 'windows-x64-setup', label: 'for Windows' }, { key: 'windows-x64-msi', label: 'MSI package' }]);+ case 'linux':+ return pick([+ { key: 'linux-appimage', label: 'for Linux (AppImage)' },+ { key: 'linux-deb', label: '.deb' },+ { key: 'linux-rpm', label: '.rpm' },+ ]);+ default:+ return { primary: null, also: [] };+ }+}++const AppleIcon = () => (+ <svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor" aria-hidden="true">+ <path d="M16.37 12.46c-.02-2.1 1.72-3.12 1.8-3.17-.98-1.43-2.5-1.63-3.04-1.65-1.29-.13-2.52.76-3.18.76-.66 0-1.67-.74-2.75-.72-1.41.02-2.72.82-3.45 2.09-1.47 2.55-.38 6.33 1.06 8.4.7 1.01 1.53 2.15 2.62 2.11 1.05-.04 1.45-.68 2.72-.68 1.27 0 1.63.68 2.74.66 1.13-.02 1.85-1.03 2.54-2.05.8-1.17 1.13-2.31 1.15-2.37-.03-.01-2.2-.84-2.21-3.38zM14.3 6.3c.58-.7.97-1.68.86-2.65-.83.03-1.84.55-2.44 1.25-.53.62-1 1.62-.88 2.57.93.07 1.88-.47 2.46-1.17z" />+ </svg>+);+const WindowsIcon = () => (+ <svg viewBox="0 0 24 24" width="15" height="15" fill="currentColor" aria-hidden="true">+ <path d="M3 5.5l7.5-1v7H3v-6zm0 13l7.5 1v-7H3v6zm8.5 1.1L21 21v-8.5h-9.5v7.1zm0-15.2v7.1H21V3l-9.5 1.4z" />+ </svg>+);+const LinuxIcon = () => (+ <svg viewBox="0 0 24 24" width="15" height="15" fill="currentColor" aria-hidden="true">+ <path d="M12 2c-2.2 0-3.6 1.8-3.6 4.4 0 1.5.4 2.6.2 3.6-.3 1.4-2.6 3.4-3.1 6-.3 1.5.3 2.5 1.2 2.9.9.4 1.4 1.1 2.3 1.6 1 .6 2.3.5 3 .5s2 .1 3-.5c.9-.5 1.4-1.2 2.3-1.6.9-.4 1.5-1.4 1.2-2.9-.5-2.6-2.8-4.6-3.1-6-.2-1 .2-2.1.2-3.6C15.6 3.8 14.2 2 12 2zm-1.4 4.2c.4 0 .7.5.7 1.1s-.3 1.1-.7 1.1-.7-.5-.7-1.1.3-1.1.7-1.1zm2.8 0c.4 0 .7.5.7 1.1s-.3 1.1-.7 1.1-.7-.5-.7-1.1.3-1.1.7-1.1zM12 9.4c.9 0 2 .6 2 1s-1.1 1.1-2 1.1-2-.7-2-1.1 1.1-1 2-1z" />+ </svg>+);++function iconFor(key: AssetKey) {+ if (key.startsWith('macos')) return <AppleIcon />;+ if (key.startsWith('windows')) return <WindowsIcon />;+ return <LinuxIcon />;+}++/**+ * The landing page's main call to action: one big "Download Mercury Desktop+ * for <this computer>" button. Before the browser has been asked (and in the+ * static HTML) it's a neutral button to /download.+ */+export default function DesktopDownload({ className }: { className?: string }): React.ReactElement {+ const [detected, setDetected] = useState<Detected>(UNKNOWN);+ const [ready, setReady] = useState(false);++ useEffect(() => {+ let live = true;+ detect().then((d) => { if (live) { setDetected(d); setReady(true); } }).catch(() => setReady(true));+ return () => { live = false; };+ }, []);++ const { primary, also } = choicesFor(detected);++ if (ready && detected.os === 'mobile') {+ return (+ <div className={clsx('mx-dl', className)}>+ <p className="mx-dl__mobile">+ Mercury Desktop runs on macOS, Windows and Linux. Open this page on your computer to download it.+ From a phone, you can <Link to="/docs/desktop/remote-access">connect to a Mercury running elsewhere</Link> or+ browse the <a href={DESKTOP.notesUrl || GITHUB_RELEASES} target="_blank" rel="noopener noreferrer">release on GitHub</a>.+ </p>+ </div>+ );+ }++ const main = primary ? asset(primary.key) : null;+ const size = sizeOf(main);++ return (+ <div className={clsx('mx-dl', className)}>+ {main && primary ? (+ <a href={main.url} className="mx-btn mx-btn--primary mx-dl__main" data-asset={primary.key}>+ {iconFor(primary.key)}+ <span>Download Mercury Desktop {primary.label}</span>+ </a>+ ) : (+ <Link to="/download" className="mx-btn mx-btn--primary mx-dl__main">+ <span>Download Mercury Desktop</span>+ </Link>+ )}+ <p className="mx-dl__meta">+ Version {DESKTOP.version}{size && ` · ${size}`}+ {also.map((c) => {+ const a = asset(c.key);+ return a ? <React.Fragment key={c.key}> · <a href={a.url}>{c.label}</a></React.Fragment> : null;+ })}+ {' · '}<Link to="/download">Other downloads</Link>+ {detected.windowsArm && <> · runs on Windows on ARM through emulation</>}+ </p>+ </div>+ );+}diff --git a/website/src/components/Download/detect.ts b/website/src/components/Download/detect.tsnew file mode 100644index 00000000..142d188a--- /dev/null+++ b/website/src/components/Download/detect.ts@@ -0,0 +1,83 @@+/**+ * Which computer is this page open on? Decided in the browser only (the+ * static HTML shows a neutral button, so a crawler or a no-JS reader still+ * gets a working link to /download).+ *+ * 1. Chromium browsers expose `navigator.userAgentData`; its high-entropy+ * `platform` and `architecture` tell Apple Silicon from Intel and spot+ * phones (`mobile`).+ * 2. Everything else (Safari, Firefox) falls back to the user agent. Safari+ * and Firefox report "Intel Mac" even on Apple Silicon, so a Mac whose+ * chip can't be read defaults to Apple Silicon (most Macs sold since+ * 2021) with Intel as the second link. The WebGL renderer name breaks+ * the tie when the browser shares it ("Apple M2" vs "Intel Iris").+ * 3. iPadOS claims to be a Mac; a "Mac" with a touch screen is a tablet.+ */++export type DetectedOs = 'macos' | 'windows' | 'linux' | 'mobile' | 'unknown';++export interface Detected {+ os: DetectedOs;+ /** For macOS: true = Apple Silicon, false = Intel, null = couldn't tell (treated as Apple Silicon). */+ appleSilicon: boolean | null;+ /** Windows on ARM: the x64 build runs under emulation. */+ windowsArm: boolean;+}++export const UNKNOWN: Detected = { os: 'unknown', appleSilicon: null, windowsArm: false };++interface UADataLike {+ mobile?: boolean;+ platform?: string;+ getHighEntropyValues?: (hints: string[]) => Promise<{ architecture?: string; platform?: string; bitness?: string }>;+}++/** Apple Silicon from the GPU name, when the browser shares it. */+function gpuSaysAppleSilicon(): boolean | null {+ try {+ const canvas = document.createElement('canvas');+ const gl = (canvas.getContext('webgl') || canvas.getContext('experimental-webgl')) as WebGLRenderingContext | null;+ if (!gl) return null;+ const ext = gl.getExtension('WEBGL_debug_renderer_info');+ const renderer = String(ext ? gl.getParameter(ext.UNMASKED_RENDERER_WEBGL) : gl.getParameter(gl.RENDERER));+ if (/apple m\d|apple gpu/i.test(renderer)) return true;+ if (/intel|amd|radeon|nvidia/i.test(renderer)) return false;+ } catch {+ /* no WebGL: can't tell */+ }+ return null;+}++export function fromUserAgent(ua: string, maxTouchPoints = 0): Detected {+ if (/iphone|ipad|ipod|android|mobile/i.test(ua)) return { ...UNKNOWN, os: 'mobile' };+ if (/macintosh|mac os x/i.test(ua)) {+ if (maxTouchPoints > 1) return { ...UNKNOWN, os: 'mobile' }; // iPadOS+ return { os: 'macos', appleSilicon: null, windowsArm: false };+ }+ if (/windows/i.test(ua)) return { os: 'windows', appleSilicon: null, windowsArm: /arm64|aarch64/i.test(ua) };+ if (/cros|linux|x11/i.test(ua)) return { ...UNKNOWN, os: 'linux' };+ return UNKNOWN;+}++export async function detect(): Promise<Detected> {+ if (typeof navigator === 'undefined') return UNKNOWN;+ const base = fromUserAgent(navigator.userAgent, navigator.maxTouchPoints || 0);+ const uaData = (navigator as Navigator & { userAgentData?: UADataLike }).userAgentData;+ if (uaData?.mobile) return { ...UNKNOWN, os: 'mobile' };++ if (uaData?.getHighEntropyValues) {+ try {+ const v = await uaData.getHighEntropyValues(['architecture', 'platform', 'bitness']);+ const platform = (v.platform || uaData.platform || '').toLowerCase();+ const arm = (v.architecture || '').toLowerCase() === 'arm';+ if (platform === 'macos') return { os: 'macos', appleSilicon: v.architecture ? arm : gpuSaysAppleSilicon(), windowsArm: false };+ if (platform === 'windows') return { os: 'windows', appleSilicon: null, windowsArm: arm };+ if (platform === 'linux' || platform === 'chrome os' || platform === 'chromeos') return { ...UNKNOWN, os: 'linux' };+ if (platform === 'android' || platform === 'ios') return { ...UNKNOWN, os: 'mobile' };+ } catch {+ /* hints refused: use the user agent */+ }+ }+ if (base.os === 'macos') return { ...base, appleSilicon: gpuSaysAppleSilicon() };+ return base;+}diff --git a/website/src/components/Download/release.ts b/website/src/components/Download/release.tsnew file mode 100644index 00000000..cc550bef--- /dev/null+++ b/website/src/components/Download/release.ts@@ -0,0 +1,60 @@+/**+ * Mercury Desktop downloads, read from src/data/desktop-release.json.+ * The release pipeline rewrites that file from the real release assets, so+ * anything here must cope with an asset that isn't there (no link) and a+ * size of 0 (no size shown).+ */+import data from '@site/src/data/desktop-release.json';++export type AssetKey =+ | 'macos-arm64'+ | 'macos-x64'+ | 'windows-x64-setup'+ | 'windows-x64-msi'+ | 'linux-appimage'+ | 'linux-deb'+ | 'linux-rpm';++export interface Asset { url: string; name: string; size: number }++interface Release {+ version: string;+ date: string;+ notesUrl: string;+ assets: Partial<Record<AssetKey, Asset>>;+}++export const DESKTOP: Release = data as Release;++export const GITHUB_RELEASES = 'https://github.com/cosmicstack-labs/mercury-agent/releases';++/** The asset, or null when this release doesn't have it. */+export function asset(key: AssetKey): Asset | null {+ const a = DESKTOP.assets[key];+ return a && a.url ? a : null;+}++/** "118 MB", or '' when the size isn't known. */+export function sizeOf(a: Asset | null): string {+ if (!a || !a.size) return '';+ const mb = a.size / 1024 / 1024;+ return mb >= 10 ? `${Math.round(mb)} MB` : `${mb.toFixed(1)} MB`;+}++/** What each download is, in words. */+export const LABEL: Record<AssetKey, { os: string; what: string; detail: string }> = {+ 'macos-arm64': { os: 'macOS', what: 'Apple Silicon', detail: 'M1 and newer, .dmg' },+ 'macos-x64': { os: 'macOS', what: 'Intel', detail: 'Intel Macs, .dmg' },+ 'windows-x64-setup': { os: 'Windows', what: 'Installer', detail: 'Windows 10 and 11, x64, .exe' },+ 'windows-x64-msi': { os: 'Windows', what: 'MSI package', detail: 'For managed installs, x64, .msi' },+ 'linux-appimage': { os: 'Linux', what: 'AppImage', detail: 'Any distribution, x64' },+ 'linux-deb': { os: 'Linux', what: 'Debian / Ubuntu', detail: 'x64, .deb' },+ 'linux-rpm': { os: 'Linux', what: 'Fedora / openSUSE', detail: 'x64, .rpm' },+};++/** "3 November 2026" from "2026-11-03". */+export function releaseDate(): string {+ const d = new Date(`${DESKTOP.date}T12:00:00Z`);+ if (Number.isNaN(d.getTime())) return DESKTOP.date;+ return d.toLocaleDateString('en-GB', { day: 'numeric', month: 'long', year: 'numeric', timeZone: 'UTC' });+}diff --git a/website/src/components/Home/InstallCommand.tsx b/website/src/components/Home/InstallCommand.tsxindex 96f066ea..57aa99ee 100644--- a/website/src/components/Home/InstallCommand.tsx+++ b/website/src/components/Home/InstallCommand.tsx@@ -20,7 +20,7 @@ const METHODS: { id: Method; label: string; cmd: string; note: React.ReactNode }id: 'npm',label: 'npm',cmd: 'npm i -g @cosmicstack/mercury-agent',- note: <>Requires Node.js 20+. Then run <code>mercury</code>.</>,+ note: <>Requires Node.js 22+. Then run <code>mercury</code>.</>,},{id: 'bun',diff --git a/website/src/components/Home/data.ts b/website/src/components/Home/data.tsindex 46ed1ae4..1456fed3 100644--- a/website/src/components/Home/data.ts+++ b/website/src/components/Home/data.ts@@ -12,7 +12,7 @@ export const NPM_URL = 'https://www.npmjs.com/package/@cosmicstack/mercury-agentexport const SKILLS_URL = 'https://skills.mercuryagent.sh';/** Bump on release, together with the announcement bar in docusaurus.config.ts. */-export const RELEASE = { version: '1.4.0', name: 'Pluggy Mercury', notes: '/docs/releases/1.4.0' };+export const RELEASE = { version: '1.5.0', name: 'Mercury Desktop', notes: '/docs/releases/1.5.0' };export const SEO = {title: 'Mercury Agent: the soul-driven AI agent, loyal only to you',@@ -304,14 +304,14 @@ export const COMPARE: { head: string[]; rows: CompareRow[] } = {['Long-term memory', 'Second Brain (SQLite, auto-extract, conflict resolution)', 'Auto memory', 'AGENTS.md', 'GEMINI.md'],['Token budget', 'Daily budget + overrides + live stats', '—', '—', '—'],['Security model', 'Permission modes + blocklist + scopes', 'Sandboxed execution + prompts', 'OS-level sandbox', 'Sandbox profiles'],- ['MCP external tools', '—', '✓', '✓', '✓'],- ['IDE surface', 'Built-in workspace (files, git)', 'VS Code, JetBrains, Desktop', 'VS Code, Cursor, Windsurf', 'IDE integrations'],+ ['MCP external tools', '✓ (each call asks in Ask Me mode)', '✓', '✓', '✓'],+ ['IDE surface', 'Mercury Desktop + built-in workspace (files, git)', 'VS Code, JetBrains, Desktop', 'VS Code, Cursor, Windsurf', 'IDE integrations'],['License', 'MIT', 'Source-available', 'Apache-2.0', 'Apache-2.0'],],};export const NOT_YET = [- { title: 'No MCP yet', body: 'Mercury doesn’t speak the Model Context Protocol today. Skills and ~50 built-in tools cover most ground, and MCP is on the roadmap.' },+ { title: 'Desktop app not code-signed yet', body: 'Mercury Desktop 1.5.0 isn’t signed with an Apple or Windows certificate, so macOS and Windows ask once before the first launch. Its updates are signed and checked before they install.' },{ title: 'No OS-level sandbox', body: 'Safety comes from approvals, a blocklist, and folder scopes. The process itself is not sandboxed, so Ask Me is the default for a reason.' },{ title: 'Signal skips Windows', body: 'The signal-cli bridge runs natively on Linux, and on macOS with Java 17+. Every other channel works on all three operating systems.' },];@@ -335,10 +335,10 @@ export const FAQ: { q: string; a: string }[] = [},{q: 'Which platforms does it run on?',- a: 'macOS, Linux, and Windows, as standalone binaries or through npm (Node.js 20+). It also runs on Android via Termux and on any cloud VM.',+ a: 'Mercury Desktop runs on macOS (Apple Silicon and Intel), Windows and Linux. The Mercury runtime runs on the same three as a standalone binary or through npm (Node.js 22+), on Android via Termux, and on any cloud VM. Mercury Desktop can connect to any of them.',},{q: 'Does it support MCP?',- a: 'Not yet. Mercury uses its own skills, based on the Agent Skills spec with 126+ in the registry, plus ~50 built-in tools. MCP support is on the roadmap.',+ a: 'Yes, since 1.5.0. Add a local or remote MCP server with mercury mcp add, allow the tools you want, and the agent can call them next to its ~50 built-in tools and 126+ skills. Every MCP call asks first in Ask Me mode.',},];diff --git a/website/src/css/home.css b/website/src/css/home.cssindex b6d98cd2..1e66f677 100644--- a/website/src/css/home.css+++ b/website/src/css/home.css@@ -340,8 +340,42 @@.mx-final .mx-lead { margin-bottom: 40px; }.mx-final__links { display: flex; gap: 28px; flex-wrap: wrap; justify-content: center; margin-top: 36px; font-size: 0.92rem; }+/* ---------- Mercury Desktop download ---------- */+.mx-dl { display: flex; flex-direction: column; align-items: center; gap: 12px; margin-top: 34px; }+.mx-dl__main { height: 52px; padding: 0 26px; font-size: 1.02rem; }+.mx-dl__meta { margin: 0; font-size: 0.86rem; color: var(--mx-ink-3); text-align: center; }+.mx-dl__mobile { max-width: 34rem; margin: 0 auto; font-size: 0.98rem; color: var(--mx-ink-2); text-align: center; line-height: 1.6; }+.mx-server-path { margin-top: 40px; }+.mx-server-path__label { font-family: var(--mx-mono); font-size: 0.74rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--mx-ink-3); text-align: center; margin: 0 0 4px; }+.mx-server-path .mx-install.mx-hero__install { margin-top: 10px; }++.mx-dlp { padding-top: 72px; }+.mx-dlp .mx-head { margin-bottom: 40px; }+.mx-dlp__notice { padding: 14px 18px; border: 1px solid var(--mx-line-2); border-radius: 12px; background: var(--mx-accent-wash); color: var(--mx-ink); margin: 0 0 24px; }+.mx-dlp__grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 16px; }+.mx-dlp__os { border: 1px solid var(--mx-line); border-radius: 16px; background: var(--mx-surface); padding: 22px 22px 18px; }+.mx-dlp__os.is-mine { border-color: var(--mx-accent); box-shadow: 0 0 0 1px var(--mx-accent); }+.mx-dlp__os-title { display: flex; align-items: center; gap: 10px; font-size: 1.15rem; color: var(--mx-ink); margin: 0 0 14px; }+.mx-dlp__mine { font-family: var(--mx-mono); font-size: 0.68rem; letter-spacing: 0.06em; text-transform: uppercase; color: var(--mx-accent); }+.mx-dlp__list { list-style: none; padding: 0; margin: 0; display: flex; flex-direction: column; gap: 8px; }+.mx-dlp__file { display: flex; flex-direction: column; gap: 2px; padding: 10px 14px; border: 1px solid var(--mx-line); border-radius: 10px; text-decoration: none !important; transition: border-color .2s, background .2s; }+.mx-dlp__file:hover { border-color: var(--mx-ink-3); background: var(--mx-bg-alt); }+.mx-dlp__what { color: var(--mx-ink); font-weight: 500; }+.mx-dlp__detail { font-size: 0.84rem; color: var(--mx-ink-3); }+.mx-dlp__none { font-size: 0.9rem; color: var(--mx-ink-3); margin: 0; }+.mx-dlp__first, .mx-dlp__server { margin-top: 64px; }+.mx-dlp__first > p, .mx-dlp__server > p { max-width: 46rem; color: var(--mx-ink-2); line-height: 1.65; }+.mx-dlp__steps { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 16px; margin-top: 18px; }+.mx-dlp__steps > div { border: 1px solid var(--mx-line); border-radius: 16px; padding: 18px 20px; background: var(--mx-surface); }+.mx-dlp__steps h3 { font-size: 1rem; color: var(--mx-ink); margin: 0 0 8px; }+.mx-dlp__steps ol { padding-left: 1.1rem; margin: 0; font-size: 0.92rem; line-height: 1.6; color: var(--mx-ink-2); }+.mx-dlp__steps li + li { margin-top: 6px; }+.mx-dlp__alt { font-size: 0.84rem; color: var(--mx-ink-3); margin: 10px 0 0; }+.mx-dlp__server .mx-install { margin: 18px 0 0; }+/* ---------- responsive ---------- */@media (max-width: 996px) {+ .mx-dlp__grid, .mx-dlp__steps { grid-template-columns: 1fr; }.mx-split, .mx-chapter { grid-template-columns: 1fr; gap: 40px; }.mx-chapter--flip .mx-chapter__copy { order: 0; }.mx-notyet { grid-template-columns: 1fr; }diff --git a/website/src/data/desktop-release.json b/website/src/data/desktop-release.jsonnew file mode 100644index 00000000..f61c80f7--- /dev/null+++ b/website/src/data/desktop-release.json@@ -0,0 +1,42 @@+{+ "version": "1.5.0",+ "date": "2026-11-03",+ "notesUrl": "https://github.com/cosmicstack-labs/mercury-agent/releases/tag/v1.5.0",+ "assets": {+ "macos-arm64": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_aarch64.dmg",+ "name": "Mercury_1.5.0_aarch64.dmg",+ "size": 0+ },+ "macos-x64": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_x64.dmg",+ "name": "Mercury_1.5.0_x64.dmg",+ "size": 0+ },+ "windows-x64-setup": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_x64-setup.exe",+ "name": "Mercury_1.5.0_x64-setup.exe",+ "size": 0+ },+ "windows-x64-msi": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_x64_en-US.msi",+ "name": "Mercury_1.5.0_x64_en-US.msi",+ "size": 0+ },+ "linux-appimage": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_amd64.AppImage",+ "name": "Mercury_1.5.0_amd64.AppImage",+ "size": 0+ },+ "linux-deb": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_amd64.deb",+ "name": "Mercury_1.5.0_amd64.deb",+ "size": 0+ },+ "linux-rpm": {+ "url": "https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury-1.5.0-1.x86_64.rpm",+ "name": "Mercury-1.5.0-1.x86_64.rpm",+ "size": 0+ }+ }+}diff --git a/website/src/pages/download.tsx b/website/src/pages/download.tsxnew file mode 100644index 00000000..59f6f65e--- /dev/null+++ b/website/src/pages/download.tsx@@ -0,0 +1,137 @@+import React, { useEffect, useState } from 'react';+import Link from '@docusaurus/Link';+import Head from '@docusaurus/Head';+import Layout from '@theme/Layout';+import clsx from 'clsx';+import InstallCommand from '@site/src/components/Home/InstallCommand';+import { SITE_URL } from '@site/src/components/Home/data';+import { detect, type DetectedOs } from '@site/src/components/Download/detect';+import { asset, sizeOf, DESKTOP, GITHUB_RELEASES, LABEL, releaseDate, type AssetKey } from '@site/src/components/Download/release';+import '@site/src/css/home.css';++const TITLE = 'Download Mercury Desktop for macOS, Windows and Linux';+const DESCRIPTION =+ 'Download Mercury Desktop, the app for Mercury Agent, for macOS (Apple Silicon and Intel), Windows and Linux. Or install the Mercury server from the command line.';++const GROUPS: { os: Exclude<DetectedOs, 'mobile' | 'unknown'>; title: string; keys: AssetKey[] }[] = [+ { os: 'macos', title: 'macOS', keys: ['macos-arm64', 'macos-x64'] },+ { os: 'windows', title: 'Windows', keys: ['windows-x64-setup', 'windows-x64-msi'] },+ { os: 'linux', title: 'Linux', keys: ['linux-appimage', 'linux-deb', 'linux-rpm'] },+];++function Platform({ group, mine }: { group: (typeof GROUPS)[number]; mine: boolean }) {+ const items = group.keys.map((k) => ({ key: k, a: asset(k) })).filter((x) => x.a);+ return (+ <section className={clsx('mx-dlp__os', mine && 'is-mine')} aria-labelledby={`dl-${group.os}`}>+ <h2 id={`dl-${group.os}`} className="mx-dlp__os-title">+ {group.title}+ {mine && <span className="mx-dlp__mine">This computer</span>}+ </h2>+ {items.length === 0 ? (+ <p className="mx-dlp__none">+ Not in this release yet. See <a href={GITHUB_RELEASES} target="_blank" rel="noopener noreferrer">all releases on GitHub</a>.+ </p>+ ) : (+ <ul className="mx-dlp__list">+ {items.map(({ key, a }) => (+ <li key={key}>+ <a href={a!.url} className="mx-dlp__file">+ <span className="mx-dlp__what">{LABEL[key].what}</span>+ <span className="mx-dlp__detail">{LABEL[key].detail}{sizeOf(a) && ` · ${sizeOf(a)}`}</span>+ </a>+ </li>+ ))}+ </ul>+ )}+ </section>+ );+}++export default function Download(): React.ReactElement {+ const [mine, setMine] = useState<DetectedOs>('unknown');+ useEffect(() => { detect().then((d) => setMine(d.os)).catch(() => {}); }, []);++ return (+ <Layout description={DESCRIPTION} wrapperClassName="mx-home">+ <Head>+ <title>{TITLE}</title>+ <meta property="og:title" content={TITLE} />+ <meta property="og:url" content={`${SITE_URL}/download`} />+ <link rel="canonical" href={`${SITE_URL}/download`} />+ </Head>+ <main className="mx-section mx-dlp">+ <div className="mx-wrap">+ <div className="mx-head mx-head--left">+ <p className="mx-kicker">Download</p>+ <h1 className="mx-h2">Mercury Desktop <em>{DESKTOP.version}</em></h1>+ <p className="mx-lead">+ Released {releaseDate()} · <a href={DESKTOP.notesUrl} target="_blank" rel="noopener noreferrer">Release notes</a> ·{' '}+ <Link to="/docs/desktop/mercury-desktop">How to set it up</Link>+ </p>+ <p className="mx-lead mx-lead--small">+ The app installs Mercury on your computer for you, or connects to a Mercury you already run elsewhere. It updates itself.+ </p>+ </div>++ {mine === 'mobile' && (+ <p className="mx-dlp__notice">+ Mercury Desktop runs on computers. Open this page on your Mac, Windows or Linux computer to download it.+ </p>+ )}++ <div className="mx-dlp__grid">+ {GROUPS.map((g) => <Platform key={g.os} group={g} mine={mine === g.os} />)}+ </div>++ <section className="mx-dlp__first" aria-labelledby="first-open">+ <h2 id="first-open" className="mx-h3">Opening it the first time</h2>+ <p>+ This release isn't code-signed yet, so your computer asks before it opens the app once. Signing is coming in a+ later release. Every update after that is checked against Mercury's update signature before it installs.+ </p>+ <div className="mx-dlp__steps">+ <div>+ <h3>macOS</h3>+ <ol>+ <li>Open the <code>.dmg</code> and drag Mercury to Applications.</li>+ <li>Open Mercury. macOS says it can't verify the developer ("Apple could not verify…"). Click <strong>Done</strong>.</li>+ <li>Open <strong>System Settings → Privacy & Security</strong>, scroll to Security and click <strong>Open Anyway</strong> next to Mercury, then confirm.</li>+ </ol>+ <p className="mx-dlp__alt">On older macOS versions you can also right-click Mercury in Applications and choose <strong>Open</strong>.</p>+ <p className="mx-dlp__alt">If macOS says Mercury "is damaged", run <code>xattr -dr com.apple.quarantine /Applications/Mercury.app</code> in Terminal, then open it again.</p>+ </div>+ <div>+ <h3>Windows</h3>+ <ol>+ <li>Run the installer.</li>+ <li>If Microsoft Defender SmartScreen says "Windows protected your PC", click <strong>More info</strong>, then <strong>Run anyway</strong>.</li>+ </ol>+ <p className="mx-dlp__alt">The <code>.msi</code> is for installs managed by an administrator.</p>+ </div>+ <div>+ <h3>Linux</h3>+ <ol>+ <li>AppImage: <code>chmod +x Mercury_*.AppImage</code>, then run it.</li>+ <li>Debian / Ubuntu: <code>sudo apt install ./Mercury_*.deb</code></li>+ <li>Fedora / openSUSE: <code>sudo dnf install ./Mercury-*.rpm</code></li>+ </ol>+ </div>+ </div>+ </section>++ <section className="mx-dlp__server" aria-labelledby="server-cli">+ <h2 id="server-cli" className="mx-h3">Run Mercury on a server</h2>+ <p>+ On a server, a Raspberry Pi or any machine without a screen, install the Mercury runtime from the command line.+ Mercury Desktop can then connect to it. See <Link to="/docs/desktop/remote-access">remote access and security</Link>.+ </p>+ <InstallCommand />+ <p className="mx-fine">+ All builds, checksums and older versions are on <a href={GITHUB_RELEASES} target="_blank" rel="noopener noreferrer">GitHub Releases</a>.+ </p>+ </section>+ </div>+ </main>+ </Layout>+ );+}diff --git a/website/src/pages/index.tsx b/website/src/pages/index.tsxindex 8cc12e98..07f2a3f6 100644--- a/website/src/pages/index.tsx+++ b/website/src/pages/index.tsx@@ -6,6 +6,7 @@ import Layout from '@theme/Layout';import Killipi from '@site/src/components/Killipi';import Terminal from '@site/src/components/Home/Terminal';import InstallCommand from '@site/src/components/Home/InstallCommand';+import DesktopDownload from '@site/src/components/Download/DesktopDownload';import {SITE_URL, GITHUB_URL, NPM_URL, SKILLS_URL, RELEASE, SEO, HERO_SCRIPT, CHAPTERS,SURFACES, CLOUD, CHANNELS, PROVIDERS, COMPARE, NOT_YET, FAQ,@@ -42,7 +43,7 @@ const JSON_LD = {operatingSystem: 'macOS, Linux, Windows, Android (Termux)',softwareVersion: RELEASE.version,license: 'https://opensource.org/licenses/MIT',- downloadUrl: `${GITHUB_URL}/releases/latest`,+ downloadUrl: `${SITE_URL}/download`,installUrl: `${SITE_URL}/docs`,image: `${SITE_URL}/img/og/home.png`,offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },@@ -90,9 +91,9 @@ function Hero({ stars }: { stars: string | null }) {<p className="mx-hero__sub">Mercury learns how you work, remembers what matters, and gets things done whileyou’re away. It runs on your machine, asks before it acts, and works with any model,- from your terminal, browser, Telegram, Discord, Slack, or Signal.+ from Mercury Desktop, your terminal, browser, Telegram, Discord, Slack, or Signal.</p>- <InstallCommand className="mx-hero__install" />+ <DesktopDownload /><div className="mx-hero__links"><Link to="/docs" className="mx-btn mx-btn--primary">Read the docs</Link><a href={GITHUB_URL} className="mx-btn" target="_blank" rel="noopener noreferrer">@@ -100,6 +101,10 @@ function Hero({ stars }: { stars: string | null }) {</a></div></div>+ <div className="mx-wrap mx-server-path">+ <p className="mx-server-path__label">Or run Mercury on a server</p>+ <InstallCommand className="mx-hero__install" />+ </div><div className="mx-wrap mx-hero__demo"><Terminal lines={HERO_SCRIPT} title="mercury — ~/projects/acme" syncGlyph /></div>@@ -326,9 +331,17 @@ function FinalCta() {<section className="mx-final" id="install" aria-labelledby="install-title"><div className="mx-wrap mx-final__inner"><h2 id="install-title" className="mx-h2">Up and running <em>in about a minute.</em></h2>- <p className="mx-lead">Install, answer the setup wizard, then run <code>mercury up</code> to keep it running for good.</p>- <InstallCommand />+ <p className="mx-lead">+ Mercury Desktop installs Mercury on your computer and keeps it updated. On a server, install it from the+ command line, answer the setup wizard, then run <code>mercury up</code> to keep it running for good.+ </p>+ <DesktopDownload />+ <div className="mx-server-path">+ <p className="mx-server-path__label">Or run Mercury on a server</p>+ <InstallCommand className="mx-hero__install" />+ </div><div className="mx-final__links">+ <Link to="/download">All downloads</Link><Link to="/docs">Getting started</Link><Link to="/docs/getting-started/platforms/macos">Platform guides</Link><Link to={RELEASE.notes}>Release notes</Link>