Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
<!doctype html><html lang=en dir=ltr class="plugin-pages plugin-id-default" data-has-hydrated=false><head><meta charset=UTF-8><meta name=generator content="Docusaurus v3.10.0"><title data-rh=true>Mercury Agent: the soul-driven AI agent, loyal only to you</title><meta data-rh=true name=viewport content="width=device-width, initial-scale=1.0"/><meta data-rh=true name=twitter:card content=summary_large_image /><meta data-rh=true property=og:locale content=en /><meta data-rh=true name=docusaurus_locale content=en /><meta data-rh=true name=docusaurus_tag content=default /><meta data-rh=true name=docsearch:language content=en /><meta data-rh=true name=docsearch:docusaurus_tag content=default /><meta data-rh=true name=keywords content="ai agent, open source ai agent, self-hosted ai agent, personal ai agent, cli agent, autonomous agent, telegram ai bot, coding agent, mercury agent"/><meta data-rh=true name=theme-color content=#0a0d10 media="(prefers-color-scheme: dark)"/><meta data-rh=true name=theme-color content=#fbfbf8 media="(prefers-color-scheme: light)"/><meta data-rh=true name=description content="Mercury is an open-source, soul-driven AI agent that runs 24/7 on your machine. It learns how you work, remembers what matters, asks before it acts, and works with any model from your terminal, browser, Telegram, Discord, Slack, or Signal."/><meta data-rh=true property=og:description content="Mercury is an open-source, soul-driven AI agent that runs 24/7 on your machine. It learns how you work, remembers what matters, asks before it acts, and works with any model from your terminal, browser, Telegram, Discord, Slack, or Signal."/><meta data-rh=true property=og:title content="Mercury Agent: the soul-driven AI agent, loyal only to you"/><meta data-rh=true name=twitter:title content="Mercury Agent: the soul-driven AI agent, loyal only to you"/><meta data-rh=true property=og:type content=website /><meta data-rh=true property=og:url content=https://mercuryagent.sh/ /><meta data-rh=true property=og:image content=https://mercuryagent.sh/img/og/home.png /><meta data-rh=true property=og:image:width content=1200 /><meta data-rh=true property=og:image:height content=630 /><meta data-rh=true property=og:image:alt content="Mercury Agent: an AI agent with a soul, loyal only to you."/><meta data-rh=true name=twitter:image content=https://mercuryagent.sh/img/og/home.png /><link data-rh=true rel=icon href=/img/logo-light.png /><link data-rh=true rel=alternate href=https://mercuryagent.sh/ hreflang=en /><link data-rh=true rel=alternate href=https://mercuryagent.sh/ hreflang=x-default /><link data-rh=true rel=canonical href=https://mercuryagent.sh/ /><script data-rh=true>document.addEventListener("DOMContentLoaded",function(){void 0===window.docusaurus&&insertBanner()});function insertBanner(){var n=document.createElement("div");n.id="__docusaurus-base-url-issue-banner-container",n.innerHTML='\n<div id="__docusaurus-base-url-issue-banner" style="border: thick solid red; background-color: rgb(255, 230, 179); margin: 20px; padding: 20px; font-size: 20px;">\n <p style="font-weight: bold; font-size: 30px;">Your Docusaurus site did not load properly.</p>\n <p>A very common reason is a wrong site <a href="https://docusaurus.io/docs/docusaurus.config.js/#baseUrl" style="font-weight: bold;">baseUrl configuration</a>.</p>\n <p>Current configured baseUrl = <span style="font-weight: bold; color: red;">/</span> (default value)</p>\n <p>We suggest trying baseUrl = <span id="__docusaurus-base-url-issue-banner-suggestion-container" style="font-weight: bold; color: green;"></span></p>\n</div>\n',document.body.prepend(n);var e=document.getElementById("__docusaurus-base-url-issue-banner-suggestion-container"),s=window.location.pathname;e.innerHTML="/"===s.substr(-1)?s:s+"/"}</script><script data-rh=true type=application/ld+json>{"@context":"https://schema.org","@graph":[{"@id":"https://mercuryagent.sh/#website","@type":"WebSite","name":"Mercury Agent","publisher":{"@id":"https://mercuryagent.sh/#org"},"url":"https://mercuryagent.sh"},{"@id":"https://mercuryagent.sh/#org","@type":"Organization","logo":"https://mercuryagent.sh/img/logo-light.png","name":"Cosmic Stack","sameAs":["https://github.com/cosmicstack-labs/mercury-agent","https://www.npmjs.com/package/@cosmicstack/mercury-agent"],"url":"https://mercuryagent.sh"},{"@id":"https://mercuryagent.sh/#app","@type":"SoftwareApplication","applicationCategory":"DeveloperApplication","applicationSubCategory":"AI agent","description":"Mercury is an open-source, soul-driven AI agent that runs 24/7 on your machine. It learns how you work, remembers what matters, asks before it acts, and works with any model from your terminal, browser, Telegram, Discord, Slack, or Signal.","downloadUrl":"https://mercuryagent.sh/download","image":"https://mercuryagent.sh/img/og/home.png","installUrl":"https://mercuryagent.sh/docs","license":"https://opensource.org/licenses/MIT","name":"Mercury Agent","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"operatingSystem":"macOS, Linux, Windows, Android (Termux)","publisher":{"@id":"https://mercuryagent.sh/#org"},"softwareVersion":"1.5.0","url":"https://mercuryagent.sh"},{"@type":"FAQPage","mainEntity":[{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"Yes. Mercury is MIT-licensed open source. You bring the model: an API key, your ChatGPT Plus/Pro or GitHub Copilot subscription through OAuth, or a local Ollama model at zero cost. Mercury Cloud is optional."},"name":"Is Mercury free?"},{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"On your machine, in ~/.mercury. Memory is a local SQLite database you can search, pause, or clear, and the agent ships no telemetry. Prompts go only to the model provider you configure. With Ollama Local, nothing leaves your machine."},"name":"Where does my data live?"},{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"In Ask Me mode, every file write, shell command, push, and scope change waits for your approval. Commands like sudo and rm -rf / are on a blocklist that never executes in any mode. Reads and writes are scoped to the folders you allow, and bots fail closed."},"name":"Could it do something destructive?"},{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"Those are coding sessions you open and close. Mercury is a personal agent that stays running: it has memory, schedules, persistent bots, and chat channels. It also includes Mercury Code, a full coding environment, for when you need one."},"name":"How is it different from Claude Code or Codex?"},{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"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."},"name":"Which platforms does it run on?"},{"@type":"Question","acceptedAnswer":{"@type":"Answer","text":"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."},"name":"Does it support MCP?"}]}]}</script><link rel=alternate type=application/rss+xml href=/blog/rss.xml title="Mercury Blog RSS Feed"><link rel=alternate type=application/atom+xml href=/blog/atom.xml title="Mercury Blog Atom Feed"><link rel=alternate type=application/json href=/blog/feed.json title="Mercury Blog JSON Feed"><meta name=twitter:site content=@mercuryagent><meta property=og:site_name content="Mercury Agent"><meta name=application-name content="Mercury Agent"><link rel=preconnect href=https://fonts.googleapis.com><link rel=preconnect href=https://fonts.gstatic.com crossorigin=anonymous><link rel=stylesheet href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&family=Instrument+Serif:ital@0;1&display=swap"><link rel=apple-touch-icon href=/img/logo-light.png><script src=https://analytics.cosmicstack.org/js/pa--flkUFvdfmsPSUtRivKAK.js async></script><script src=/js/plausible-init.js></script><link rel=stylesheet href=/assets/css/styles.b525f68d.css /><script src=/assets/js/runtime~main.c3075c62.js defer></script><script src=/assets/js/main.69097411.js defer></script></head><body><svg style="display: none;"><defs>
<symbol id=theme-svg-external-link viewBox="0 0 24 24"><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
</defs></svg>
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme-ebb")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{for(var[t,e]of new URLSearchParams(window.location.search).entries())if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}(),document.documentElement.setAttribute("data-announcement-bar-initially-dismissed",function(){try{return"true"===localStorage.getItem("docusaurus.announcement.dismiss-ebb")}catch(t){}return!1}())</script><div id=__docusaurus><link rel=preload as=image href=/img/logo-light.png /><link rel=preload as=image href=/img/logo-dark.png /><div role=region aria-label="Skip to main content"><a class=skipToContent_fXgn href=#__docusaurus_skipToContent_fallback>Skip to main content</a></div><div class="theme-announcement-bar announcementBar_mb4j" role=banner><div class=announcementBarPlaceholder_vyr4></div><div class="content_knG7 announcementBarContent_xLdY">☿ 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></div><button type=button aria-label=Close class="clean-btn close closeButton_CVFx announcementBarClose_gvF7"><svg viewBox="0 0 15 15" width=14 height=14><g stroke=currentColor stroke-width=3.1><path d="M.75.75l13.5 13.5M14.25.75L.75 14.25"/></g></svg></button></div><nav aria-label=Main class="theme-layout-navbar navbar navbar--fixed-top"><div class=navbar__inner><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded=false class="navbar__toggle clean-btn" type=button><svg width=30 height=30 viewBox="0 0 30 30" aria-hidden=true><path stroke=currentColor stroke-linecap=round stroke-miterlimit=10 stroke-width=2 d="M4 7h22M4 15h22M4 23h22"/></svg></button><a class=navbar__brand href=/><div class=navbar__logo><img src=/img/logo-light.png alt="Mercury Agent" class="themedComponent_mlkZ themedComponent--light_NVdE"/><img src=/img/logo-dark.png alt="Mercury Agent" class="themedComponent_mlkZ themedComponent--dark_xIcU"/></div><b class="navbar__title text--truncate">Mercury</b></a><a class="navbar__item navbar__link" href=/docs>Docs</a><a class="navbar__item navbar__link" href=/docs/integrations/coding-workspace>Code</a><a class="navbar__item navbar__link" href=/docs/integrations/mercury-bots>Bots</a><a class="navbar__item navbar__link" href=/cloud>Cloud</a><a href=https://skills.mercuryagent.sh target=_blank rel="noopener noreferrer" class="navbar__item navbar__link">Skills<svg width=13.5 height=13.5 aria-label="(opens in new tab)" class=iconExternalLink_nPIU><use href=#theme-svg-external-link /></svg></a><a class="navbar__item navbar__link" href=/blog>Blog</a><a class="navbar__item navbar__link" href=/docs/releases>Changelog</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href=https://github.com/cosmicstack-labs/mercury-agent target=_blank rel="noopener noreferrer" class="navbar__item navbar__link navbar-github" aria-label="Mercury Agent on GitHub"></a><a class="navbar__item navbar__link navbar-cta" href=/download>Download</a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type=button disabled title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill=currentColor d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill=currentColor d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_g3eP systemToggleIcon_QzmC"><path fill=currentColor d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"/></svg></button></div><div class=navbarSearchContainer_Bca1><div class="navbar__search searchBarContainer_NW3z" dir=ltr><input placeholder=Search aria-label=Search class="navbar__search-input searchInput_YFbd" value="" /><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role=presentation class=navbar-sidebar__backdrop></div></nav><div id=__docusaurus_skipToContent_fallback class="theme-layout-main main-wrapper mainWrapper_z2l0 mx-home"><main><header class=mx-hero><div class="mx-wrap mx-hero__inner"><div class=mx-hero__glyph><div class=kp-wrap><div id=killipi-orb role=img aria-label="Killipi — Mercury's mascot. Interact by moving the cursor or clicking."><div class=kp-ambient aria-hidden=true></div><svg id=killipi-orb-svg viewBox="0 0 84 68" xmlns=http://www.w3.org/2000/svg class=kp-svg><g class=kp-rings><ellipse class="kp-ring kp-ring-a" cx=42 cy=34 rx=34 ry=13.5 /><ellipse class="kp-ring-b kp-ring" cx=42 cy=34 rx=34 ry=13.5 /></g><g class=kp-core style="transform:translate(0px, 0px)"><circle cx=42 cy=34 r=17 class=kp-orb /><path d="M 42 17 A 17 17 0 0 0 42 51 A 12.5 12.5 0 0 1 42 17 Z" class=kp-crescent fill=none /><circle cx=42 cy=34 r=14 class=kp-inner /><circle cx=37 cy=40 r=2.4 fill=var(--kp-feature) /><circle cx=47 cy=40 r=2.4 fill=var(--kp-feature) /><path d="M 39.5 47 Q 42 49 44.5 47" stroke=var(--kp-feature) stroke-width=1.5 fill=none stroke-linecap=round /><g class=kp-symbol><line x1=42 y1=51 x2=42 y2=62 /><line x1=36 y1=57 x2=48 y2=57 /></g></g></svg></div><div class=kp-voice style=opacity:1>I keep a second brain so you don’t have to.</div></div></div><a class=mx-pill href=/docs/releases/1.5.0><span class=mx-pill__dot aria-hidden=true></span>New in <!-- -->1.5.0<!-- -->: <!-- -->Mercury Desktop<span aria-hidden=true>→</span></a><p class=mx-hero__eyebrow><span aria-hidden=true>☿</span> Soul-driven AI agent<h1 class=mx-hero__title>An AI agent with a soul, <em>loyal only to you.</em></h1><p class=mx-hero__sub>Mercury learns how you work, remembers what matters, and gets things done while you’re away. It runs on your machine, asks before it acts, and works with any model, from Mercury Desktop, your terminal, browser, Telegram, Discord, Slack, or Signal.<section class=mx-hero-install aria-label="Install Mercury"><div class=mx-hero-install__head><div class=mx-hero-install__tabs role=tablist aria-label="Where to install"><button type=button role=tab aria-selected=true class="mx-hero-install__tab is-active">Desktop app</button><button type=button role=tab aria-selected=false class=mx-hero-install__tab>Server / CLI</button></div><p class=mx-hero-install__version><span class=mx-hero-install__badge>v<!-- -->1.5.0</span>3 November 2026<!-- --> · <a href=/docs/releases/1.5.0>What's new</a></div><div class=mx-hero-install__body role=tabpanel><div class=mx-dl><a class="mx-btn mx-btn--primary mx-dl__main" href=/download><span>Download Mercury Desktop</span></a><p class=mx-dl__meta>Version <!-- -->1.5.0<!-- --> · <a href=/download>Other downloads</a></div><ul class=mx-platforms aria-label="Mercury Desktop for every platform"><li><a href=https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_aarch64.dmg class=mx-platforms__item data-asset=macos-arm64><span class=mx-platforms__icon><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></span><span class=mx-platforms__text><span class=mx-platforms__os>macOS</span><span class=mx-platforms__what>Apple Silicon<!-- --> · 5.2 MB</span></span></a><li><a href=https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_x64.dmg class=mx-platforms__item data-asset=macos-x64><span class=mx-platforms__icon><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></span><span class=mx-platforms__text><span class=mx-platforms__os>macOS</span><span class=mx-platforms__what>Intel<!-- --> · 5.5 MB</span></span></a><li><a href=https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_x64-setup.exe class=mx-platforms__item data-asset=windows-x64-setup><span class=mx-platforms__icon><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></span><span class=mx-platforms__text><span class=mx-platforms__os>Windows</span><span class=mx-platforms__what>x64 installer<!-- --> · 4.2 MB</span></span></a><li><a href=https://github.com/cosmicstack-labs/mercury-agent/releases/download/v1.5.0/Mercury_1.5.0_amd64.AppImage class=mx-platforms__item data-asset=linux-appimage><span class=mx-platforms__icon><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></span><span class=mx-platforms__text><span class=mx-platforms__os>Linux</span><span class=mx-platforms__what>AppImage<!-- --> · 81 MB</span></span></a></ul><p class=mx-hero-install__note>Free and open source. Not code-signed yet: <!-- -->your computer<!-- --> asks once before the first launch (<a href=/download#first-open>how</a>). Updates arrive in the app.</div></section><div class=mx-hero__links><a class="mx-btn mx-btn--primary" href=/docs>Read the docs</a><a href=https://github.com/cosmicstack-labs/mercury-agent class=mx-btn target=_blank rel="noopener noreferrer"><svg viewBox="0 0 16 16" width=15 height=15 fill=currentColor aria-hidden=true><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> Star on GitHub</a></div></div><div class="mx-wrap mx-hero__demo"><figure class="mx-term mx-term--static"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury — ~/projects/acme</em></div><div class=mx-term__body><div class="mx-tl mx-tl--cmd" style=--i:0><span class=mx-tl__mark aria-hidden=true>$</span><span class=mx-tl__text>mercury</span></div><div class="mx-tl mx-tl--dim" style=--i:1><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text>☿ Mercury 1.3.1 · deepseek-chat · Ask Me mode</span></div><div class="mx-tl mx-tl--gap" style=--i:2><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text></span></div><div class="mx-tl mx-tl--in" style=--i:3><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>tidy CHANGELOG for 1.3.1, push it, and open a PR</span></div><div class="mx-tl mx-tl--ok" style=--i:4><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>git_status</span><span class=mx-tl__note>read · no prompt</span></div><div class="mx-tl mx-tl--ok" style=--i:5><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>read_file CHANGELOG.md</span><span class=mx-tl__note>read · no prompt</span></div><div class="mx-tl mx-tl--ok" style=--i:6><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>edit_file CHANGELOG.md</span><span class=mx-tl__note>+14 −2</span></div><div class="mx-tl mx-tl--ok" style=--i:7><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>git_commit "docs: changelog for 1.3.1"</span></div><div class="mx-tl mx-tl--ask" style=--i:8><span class=mx-tl__mark aria-hidden=true>?</span><span class=mx-tl__text>git_push origin docs/changelog-1.3.1 — modifies a remote</span></div><div class="mx-tl mx-tl--sel" style=--i:9><span class=mx-tl__mark aria-hidden=true>❯</span><span class=mx-tl__text>Yes — approve once</span></div><div class="mx-tl mx-tl--opt" style=--i:10><span class=mx-tl__mark aria-hidden=true> </span><span class=mx-tl__text>Always — remember this permission</span></div><div class="mx-tl mx-tl--opt" style=--i:11><span class=mx-tl__mark aria-hidden=true> </span><span class=mx-tl__text>No — deny</span></div><div class="mx-tl mx-tl--ok" style=--i:12><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>git_push</span><span class=mx-tl__note>approved once</span></div><div class="mx-tl mx-tl--ok" style=--i:13><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>create_pr #214 "docs: changelog for 1.3.1"</span></div><div class="mx-tl mx-tl--done" style=--i:14><span class=mx-tl__mark aria-hidden=true>■</span><span class=mx-tl__text>Task complete · 6 steps · 38s</span></div><div class="mx-tl mx-tl--mem" style=--i:15><span class=mx-tl__mark aria-hidden=true>◆</span><span class=mx-tl__text>Remembered · changelog PRs go on a docs/* branch</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></div></header><section class=mx-strip aria-label="At a glance"><div class="mx-wrap mx-strip__grid"><div class=mx-strip__item><span class=mx-strip__big>MIT</span><span class=mx-strip__small>open source, self-hosted</span></div><div class=mx-strip__item><span class=mx-strip__big>Local</span><span class=mx-strip__small>memory in SQLite on your disk</span></div><div class=mx-strip__item><span class=mx-strip__big>0</span><span class=mx-strip__small>telemetry in the agent</span></div><div class=mx-strip__item><span class=mx-strip__big>~50</span><span class=mx-strip__small>built-in tools, permission-gated</span></div><div class=mx-strip__item><span class=mx-strip__big>10+</span><span class=mx-strip__small>model providers, auto-fallback</span></div></div></section><section class=mx-section id=trust aria-labelledby=trust-title><div class=mx-wrap><div class=mx-head><p class=mx-kicker>Built on trust<h2 id=trust-title class=mx-h2>An agent is only useful <em>if you can rely on it.</em></h2><p class=mx-lead>Most agents are built to impress in a demo. Mercury is built for the day after, when it is running on its own with access to your files, your accounts, and your time.</div><div class=mx-chapters><article id=asks-first class="mx-chapter "><div class=mx-chapter__copy><p class=mx-kicker>01 · Control<h3 class=mx-h3>It asks before it acts.</h3><p>Reads are free. Anything that writes, runs, pushes, or reaches outside its scope waits for your answer. Approve once, approve for good, or say no. Some commands never run, no matter what mode you pick.<ul class=mx-list><li>Ask Me or Allow All, chosen per session<li>Shell blocklist: sudo, rm -rf /, and its flag-swapped variants<li>Folder-level read/write scopes per channel and per sender role<li>Bots fail closed: a missing permission is a denial, not a pop-up</ul><a class=mx-arrow href=/docs/reference/permissions>How permissions work<!-- --> →</a></div><figure class="mx-term mx-term--static mx-chapter__term"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury · ask me</em></div><div class=mx-term__body><div class="mx-tl mx-tl--in" style=--i:0><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>clear out the build cache and old logs</span></div><div class="mx-tl mx-tl--ok" style=--i:1><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>list_dir ./build</span><span class=mx-tl__note>read · no prompt</span></div><div class="mx-tl mx-tl--ask" style=--i:2><span class=mx-tl__mark aria-hidden=true>?</span><span class=mx-tl__text>run_command rm -rf build/.cache logs/*.old</span></div><div class="mx-tl mx-tl--sel" style=--i:3><span class=mx-tl__mark aria-hidden=true>❯</span><span class=mx-tl__text>Yes — approve once</span></div><div class="mx-tl mx-tl--opt" style=--i:4><span class=mx-tl__mark aria-hidden=true> </span><span class=mx-tl__text>Always — remember this permission</span></div><div class="mx-tl mx-tl--opt" style=--i:5><span class=mx-tl__mark aria-hidden=true> </span><span class=mx-tl__text>No — deny</span></div><div class="mx-tl mx-tl--ok" style=--i:6><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>run_command</span><span class=mx-tl__note>approved once</span></div><div class="mx-tl mx-tl--gap" style=--i:7><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text></span></div><div class="mx-tl mx-tl--in" style=--i:8><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>now wipe everything under /</span></div><div class="mx-tl mx-tl--warn" style=--i:9><span class=mx-tl__mark aria-hidden=true>!</span><span class=mx-tl__text>Blocked · `rm -rf /` is on the shell blocklist. It never runs, in any mode.</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></article><article id=remembers class="mx-chapter mx-chapter--flip"><div class=mx-chapter__copy><p class=mx-kicker>02 · Memory<h3 class=mx-h3>It remembers what matters.</h3><p>A Second Brain on your own disk. Mercury pulls out preferences, people, and decisions as you work, resolves contradictions, and consolidates every hour, so tomorrow does not start from zero.<ul class=mx-list><li>SQLite + FTS5 full-text search, stored in ~/.mercury<li>10 memory types, auto-extraction, conflict resolution<li>/memory to search, pause, or clear it at any time<li>Personality lives in markdown files you own: soul.md, persona.md</ul><a class=mx-arrow href=/docs/reference/second-brain>Inside the Second Brain<!-- --> →</a></div><figure class="mx-term mx-term--static mx-chapter__term"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury · second brain</em></div><div class=mx-term__body><div class="mx-tl mx-tl--in" style=--i:0><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>draft the weekly update for the team</span></div><div class="mx-tl mx-tl--ok" style=--i:1><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>search_memory "weekly update"</span><span class=mx-tl__note>3 hits</span></div><div class="mx-tl mx-tl--dim" style=--i:2><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text> · prefers bullet points, no emoji</span></div><div class="mx-tl mx-tl--dim" style=--i:3><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text> · Friday updates go to #eng-leads</span></div><div class="mx-tl mx-tl--dim" style=--i:4><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text> · Priya owns the billing migration</span></div><div class="mx-tl mx-tl--say" style=--i:5><span class=mx-tl__mark aria-hidden=true>☿</span><span class=mx-tl__text>Drafted in your usual format: bullets, billing migration first (Priya), ready for #eng-leads.</span></div><div class="mx-tl mx-tl--mem" style=--i:6><span class=mx-tl__mark aria-hidden=true>◆</span><span class=mx-tl__text>Updated · billing migration moved to "in review"</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></article><article id=always-on class="mx-chapter "><div class=mx-chapter__copy><p class=mx-kicker>03 · Autonomy<h3 class=mx-h3>It keeps working when you don’t.</h3><p>One command makes Mercury a background service that starts on boot and restarts itself on a crash. Schedule routines, run a fleet of persistent bots, and hear back on whichever channel you are on.<ul class=mx-list><li>mercury up: system service, crash recovery, boot start<li>Cron schedules, heartbeat checks, proactive notifications<li>Mercury Bots: persistent specialists with their own model and memory<li>Durable job queue: work survives restarts and failures can be replayed</ul><a class=mx-arrow href=/docs/integrations/mercury-bots>Meet Mercury Bots<!-- --> →</a></div><figure class="mx-term mx-term--static mx-chapter__term"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury · daemon</em></div><div class=mx-term__body><div class="mx-tl mx-tl--cmd" style=--i:0><span class=mx-tl__mark aria-hidden=true>$</span><span class=mx-tl__text>mercury up</span></div><div class="mx-tl mx-tl--ok" style=--i:1><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>service installed · starts on boot</span></div><div class="mx-tl mx-tl--ok" style=--i:2><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>daemon running</span><span class=mx-tl__note>pid 48211</span></div><div class="mx-tl mx-tl--gap" style=--i:3><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text></span></div><div class="mx-tl mx-tl--dim" style=--i:4><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text>07:00 ◷ daily-brief → Telegram</span></div><div class="mx-tl mx-tl--dim" style=--i:5><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text>09:00 ✒ release-notes bot → drafted 620 words</span></div><div class="mx-tl mx-tl--dim" style=--i:6><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text>09:02 ⚑ fact-checker → 14/14 sourced</span></div><div class="mx-tl mx-tl--warn" style=--i:7><span class=mx-tl__mark aria-hidden=true>!</span><span class=mx-tl__text>11:40 needs you · deploy bot wants shell access it was never granted</span></div><div class="mx-tl mx-tl--done" style=--i:8><span class=mx-tl__mark aria-hidden=true>■</span><span class=mx-tl__text>Fleet idle · journals clean · 0 in dead-letter queue</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></article><article id=honest class="mx-chapter mx-chapter--flip"><div class=mx-chapter__copy><p class=mx-kicker>04 · Honesty<h3 class=mx-h3>It tells you the truth about “done”.</h3><p>Agents love to say “task complete”. Mercury works under a completion contract: a task ends either verified, with a build, typecheck, or test that actually ran, or paused with the blocker named. Mercury never claims success it can’t show.<ul class=mx-list><li>Evidence-gated completion banners in Mercury Code<li>Honest pauses that name the blocker, never a silent stop<li>Daily token budgets with live usage and Token Saver Mode<li>Provider fallback mid-task, so one outage does not end the run</ul><a class=mx-arrow href=/docs/reference/completion-architecture>The completion contract<!-- --> →</a></div><figure class="mx-term mx-term--static mx-chapter__term"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury code · auto</em></div><div class=mx-term__body><div class="mx-tl mx-tl--in" style=--i:0><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>migrate the settings page to the new form library</span></div><div class="mx-tl mx-tl--ok" style=--i:1><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>edit_file src/settings/Form.tsx</span><span class=mx-tl__note>+86 −41</span></div><div class="mx-tl mx-tl--ok" style=--i:2><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>run_command npm run typecheck</span><span class=mx-tl__note>0 errors</span></div><div class="mx-tl mx-tl--ok" style=--i:3><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>run_command npm test settings</span><span class=mx-tl__note>12 passed</span></div><div class="mx-tl mx-tl--done" style=--i:4><span class=mx-tl__mark aria-hidden=true>■</span><span class=mx-tl__text>Task complete · 9 steps · 2m 14s</span><span class=mx-tl__note>verified</span></div><div class="mx-tl mx-tl--gap" style=--i:5><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text></span></div><div class="mx-tl mx-tl--in" style=--i:6><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>and the billing page</span></div><div class="mx-tl mx-tl--ok" style=--i:7><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>edit_file src/billing/Form.tsx</span><span class=mx-tl__note>+52 −30</span></div><div class="mx-tl mx-tl--warn" style=--i:8><span class=mx-tl__mark aria-hidden=true>!</span><span class=mx-tl__text>Paused · npm test billing fails (2). Not calling this done. Say "continue" to resume.</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></article></div></div></section><section class="mx-section mx-section--alt" id=products aria-labelledby=products-title><div class=mx-wrap><div class=mx-head><p class=mx-kicker>Three ways to work with it<h2 id=products-title class=mx-h2>One agent. <em>Code, chat, or a whole crew.</em></h2></div><div class=mx-surface-tabs role=tablist aria-label="Mercury surfaces"><button type=button role=tab id=surface-tab-0 aria-selected=true aria-controls=surface-panel class="mx-surface-tab is-active"><span class=mx-surface-tab__cmd>/code</span><span class=mx-surface-tab__name>Mercury Code</span></button><button type=button role=tab id=surface-tab-1 aria-selected=false aria-controls=surface-panel class="mx-surface-tab "><span class=mx-surface-tab__cmd>/chat</span><span class=mx-surface-tab__name>Mercury Chat</span></button><button type=button role=tab id=surface-tab-2 aria-selected=false aria-controls=surface-panel class="mx-surface-tab "><span class=mx-surface-tab__cmd>/bots</span><span class=mx-surface-tab__name>Mercury Bots</span></button></div><div class=mx-surface id=surface-panel role=tabpanel aria-labelledby=surface-tab-0><div class=mx-surface__copy><h3 class=mx-surface__title>A senior engineer<!-- --> <em>inside your repo.</em></h3><p>A full-screen, repo-aware coding environment. Mercury plans and builds in one AUTO flow, shows every step on a live checklist, and only calls a task done after a build, typecheck, or test actually ran.<ul class=mx-list><li>AUTO mode: plan and build in one flow, one confirmation for big changes<li>Live plan checklist, per-file diffs, and a workspace IDE (/ws)<li>/code agent hands work to a background sub-agent while you keep chatting<li>Stall watchdog, compact-on-pressure, provider fallback mid-task</ul><a class=mx-arrow href=/docs/integrations/coding-workspace>Explore Mercury Code<!-- --> →</a></div><figure class="mx-term mx-term--static"><div class=mx-term__bar aria-hidden=true><span></span><span></span><span></span><em>mercury code · auto</em></div><div class=mx-term__body><div class="mx-tl mx-tl--cmd" style=--i:0><span class=mx-tl__mark aria-hidden=true>$</span><span class=mx-tl__text>mercury code ~/projects/acme</span></div><div class="mx-tl mx-tl--dim" style=--i:1><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text>☿ Mercury Code · AUTO · branch main</span></div><div class="mx-tl mx-tl--gap" style=--i:2><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text></span></div><div class="mx-tl mx-tl--in" style=--i:3><span class=mx-tl__mark aria-hidden=true>›</span><span class=mx-tl__text>refactor the auth module to JWT and add tests</span></div><div class="mx-tl mx-tl--ok" style=--i:4><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>read_file src/auth/handler.ts</span><span class=mx-tl__note>plan 1/4</span></div><div class="mx-tl mx-tl--ok" style=--i:5><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>create_file src/auth/jwt.ts</span><span class=mx-tl__note>+64</span></div><div class="mx-tl mx-tl--ok" style=--i:6><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>edit_file src/auth/handler.ts</span><span class=mx-tl__note>+31 −48</span></div><div class="mx-tl mx-tl--ok" style=--i:7><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>create_file tests/auth.test.ts</span><span class=mx-tl__note>+112</span></div><div class="mx-tl mx-tl--ok" style=--i:8><span class=mx-tl__mark aria-hidden=true>✓</span><span class=mx-tl__text>run_command npm test</span><span class=mx-tl__note>8 passed</span></div><div class="mx-tl mx-tl--done" style=--i:9><span class=mx-tl__mark aria-hidden=true>■</span><span class=mx-tl__text>Task complete · 6 steps · 34s</span><span class=mx-tl__note>verified</span></div><div class="mx-tl mx-tl--dim" style=--i:10><span class=mx-tl__mark aria-hidden=true></span><span class=mx-tl__text> 3 files changed · /code diff to review · /ws to commit</span></div><span class=mx-term__cursor aria-hidden=true></span></div></figure></div><div class=mx-visually-hidden><section><h3>Mercury Chat<!-- --> (<!-- -->/chat<!-- -->): <!-- -->Talk to it like<!-- --> <!-- -->someone who knows you.</h3><p>The everyday Mercury: ask, plan, delegate, schedule. It answers from what it remembers about you, works with ~50 built-in tools, and follows you from the terminal to Telegram, Discord, Slack, Signal, or the web.</section><section><h3>Mercury Bots<!-- --> (<!-- -->/bots<!-- -->): <!-- -->A small team,<!-- --> <!-- -->not a single chat.</h3><p>Persistent bots, each with its own persona, model, memory, and permissions. Send one a job and keep talking to Mercury: the bot works in the background and delivers to its own thread. Promote one to fleet lead and it recruits a crew.</section></div><a class=mx-cloud-row href=/cloud><span class=mx-cloud-row__name>Mercury Cloud</span><span class=mx-cloud-row__body>Optional. Pair from the terminal and keep your agent reachable from anywhere, with no port forwarding, reverse proxy, or certificates.</span><span class=mx-arrow aria-hidden=true>→</span></a></div></section><section class=mx-section id=channels aria-labelledby=channels-title><div class="mx-wrap mx-split"><div class="mx-head mx-head--left"><p class=mx-kicker>Everywhere you are<h2 id=channels-title class=mx-h2>Six channels. <em>One memory.</em></h2><p class=mx-lead>Every channel shares one tool registry, one permission system, and one Second Brain. Start a task in the terminal and check on it from Telegram.<p class="mx-lead mx-lead--small">Extend it with <a href=https://skills.mercuryagent.sh target=_blank rel="noopener noreferrer">126+ community skills</a>, based on the open Agent Skills spec. Install one with a single command after reading its source.</div><div><ul class=mx-channels><li><strong>Terminal</strong><span>Ink TUI, slash commands, workspace IDE</span><li><strong>Web</strong><span>Local dashboard, Kanban, bot cockpit</span><li><strong>Telegram</strong><span>Pinned status card, admin/member roles</span><li><strong>Discord</strong><span>Slash commands, streaming edits</span><li><strong>Slack</strong><span>Socket Mode, no public endpoint</span><li><strong>Signal</strong><span>End-to-end encrypted via signal-cli</span></ul><p class=mx-providers-label>Works with<ul class=mx-providers><li>Anthropic<li>OpenAI<li>DeepSeek<li>Grok<li>ChatGPT Plus / Pro<li>GitHub Copilot<li>Ollama Local<li>Ollama Cloud<li>Atomic Chat<li>Mercury Cloud</ul></div></div></section><section class="mx-section mx-section--alt" id=compare aria-labelledby=compare-title><div class=mx-wrap><div class=mx-head><p class=mx-kicker>Honest by design<h2 id=compare-title class=mx-h2>How Mercury compares, <em>including where it doesn’t win.</em></h2><p class=mx-lead>Checked in September 2026 against each product’s official docs and public repos. Rows where Mercury loses are left in on purpose.</div><div class=mx-table-wrap><table class=mx-table><thead><tr><th scope=col><th scope=col>Mercury<th scope=col>Claude Code<th scope=col>Codex CLI<th scope=col>Gemini CLI<tbody><tr><th scope=row>Model providers<td>Any provider, API key or OAuth, auto-fallback<td>Anthropic + third-party<td>OpenAI only<td>Gemini only<tr><th scope=row>Scheduled autonomy<td>Daemon + cron + bot routines, 24/7 local<td>Cloud routines + desktop tasks<td class=is-no>—<td class=is-no>—<tr><th scope=row>Persistent agents<td>Bots with persona, memory, permissions<td>Sub-agents + background agents<td class=is-no>—<td class=is-no>—<tr><th scope=row>Messaging channels<td>Telegram, Discord, Slack, Signal, Web<td>Slack, Telegram, Discord, iMessage<td class=is-no>—<td class=is-no>—<tr><th scope=row>Long-term memory<td>Second Brain (SQLite, auto-extract, conflict resolution)<td>Auto memory<td>AGENTS.md<td>GEMINI.md<tr><th scope=row>Token budget<td>Daily budget + overrides + live stats<td class=is-no>—<td class=is-no>—<td class=is-no>—<tr><th scope=row>Security model<td>Permission modes + blocklist + scopes<td>Sandboxed execution + prompts<td>OS-level sandbox<td>Sandbox profiles<tr><th scope=row>MCP external tools<td>✓ (each call asks in Ask Me mode)<td class=is-yes>✓<td class=is-yes>✓<td class=is-yes>✓<tr><th scope=row>IDE surface<td>Mercury Desktop + built-in workspace (files, git)<td>VS Code, JetBrains, Desktop<td>VS Code, Cursor, Windsurf<td>IDE integrations<tr><th scope=row>License<td>MIT<td>Source-available<td>Apache-2.0<td>Apache-2.0</table></div><div class=mx-notyet><div class=mx-notyet__item><h3>Desktop app not code-signed yet</h3><p>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.</div><div class=mx-notyet__item><h3>No OS-level sandbox</h3><p>Safety comes from approvals, a blocklist, and folder scopes. The process itself is not sandboxed, so Ask Me is the default for a reason.</div><div class=mx-notyet__item><h3>Signal skips Windows</h3><p>The signal-cli bridge runs natively on Linux, and on macOS with Java 17+. Every other channel works on all three operating systems.</div></div><p class=mx-fine>Spotted a cell that’s wrong? <a href=https://github.com/cosmicstack-labs/mercury-agent/issues target=_blank rel="noopener noreferrer">Open an issue</a> and we’ll fix it.</div></section><section class=mx-section id=faq aria-labelledby=faq-title><div class="mx-wrap mx-split"><div class="mx-head mx-head--left"><p class=mx-kicker>Questions<h2 id=faq-title class=mx-h2>Before you <em>hand it the keys.</em></h2></div><div class=mx-faq><details><summary>Is Mercury free?</summary><p>Yes. Mercury is MIT-licensed open source. You bring the model: an API key, your ChatGPT Plus/Pro or GitHub Copilot subscription through OAuth, or a local Ollama model at zero cost. Mercury Cloud is optional.</details><details><summary>Where does my data live?</summary><p>On your machine, in ~/.mercury. Memory is a local SQLite database you can search, pause, or clear, and the agent ships no telemetry. Prompts go only to the model provider you configure. With Ollama Local, nothing leaves your machine.</details><details><summary>Could it do something destructive?</summary><p>In Ask Me mode, every file write, shell command, push, and scope change waits for your approval. Commands like sudo and rm -rf / are on a blocklist that never executes in any mode. Reads and writes are scoped to the folders you allow, and bots fail closed.</details><details><summary>How is it different from Claude Code or Codex?</summary><p>Those are coding sessions you open and close. Mercury is a personal agent that stays running: it has memory, schedules, persistent bots, and chat channels. It also includes Mercury Code, a full coding environment, for when you need one.</details><details><summary>Which platforms does it run on?</summary><p>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.</details><details><summary>Does it support MCP?</summary><p>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.</details></div></div></section><section class=mx-final id=install aria-labelledby=install-title><div class="mx-wrap mx-final__inner"><h2 id=install-title class=mx-h2>Up and running <em>in about a minute.</em></h2><p class=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.<div class=mx-dl><a class="mx-btn mx-btn--primary mx-dl__main" href=/download><span>Download Mercury Desktop</span></a><p class=mx-dl__meta>Version <!-- -->1.5.0<!-- --> · <a href=/download>Other downloads</a></div><div class=mx-server-path><p class=mx-server-path__label>Or run Mercury on a server<div class="mx-install mx-hero__install"><div class=mx-install__tabs role=tablist aria-label="Install method"><button type=button role=tab aria-selected=true class="mx-install__tab is-active">macOS / Linux</button><button type=button role=tab aria-selected=false class=mx-install__tab>Windows</button><button type=button role=tab aria-selected=false class=mx-install__tab>npm</button><button type=button role=tab aria-selected=false class=mx-install__tab>bun</button></div><div class=mx-install__cmd><span class=mx-install__prompt aria-hidden=true>$</span><code>curl -fsSL https://mercuryagent.sh/install.sh | sh</code><button type=button class=mx-install__copy aria-label="Copy install command">Copy</button></div><p class=mx-install__note>Standalone binary, no Node.js needed. <a href=/install.sh>Read the script first</a>.</div></div><div class=mx-final__links><a href=/download>All downloads</a><a href=/docs>Getting started</a><a href=/docs/getting-started/platforms/macos>Platform guides</a><a href=/docs/releases/1.5.0>Release notes</a><a href=https://github.com/cosmicstack-labs/mercury-agent target=_blank rel="noopener noreferrer">Source on GitHub</a></div></div></section></main></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Product</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/download>Download</a><li class=footer__item><a class=footer__link-item href=/#install>Install on a server</a><li class=footer__item><a class=footer__link-item href=/docs/integrations/coding-workspace>Mercury Code</a><li class=footer__item><a class=footer__link-item href=/docs/integrations/mercury-bots>Mercury Bots</a><li class=footer__item><a class=footer__link-item href=/cloud>Mercury Cloud</a><li class=footer__item><a class=footer__link-item href=/blog>Blog</a><li class=footer__item><a class=footer__link-item href=/docs/releases>Changelog</a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Trust</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/docs/reference/permissions>Permissions model</a><li class=footer__item><a class=footer__link-item href=/docs/reference/second-brain>Second Brain memory</a><li class=footer__item><a class=footer__link-item href=/docs/reference/completion-architecture>Completion contract</a><li class=footer__item><a class=footer__link-item href=/#compare>Honest comparison</a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Docs</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/docs>Getting started</a><li class=footer__item><a class=footer__link-item href=/docs/cli-commands/cli-commands>CLI commands</a><li class=footer__item><a class=footer__link-item href=/docs/reference/built-in-tools>Built-in tools</a><li class=footer__item><a class=footer__link-item href=/docs/reference/configuration>Configuration</a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Community</div><ul class="footer__items clean-list"><li class=footer__item><a href=https://github.com/cosmicstack-labs/mercury-agent target=_blank rel="noopener noreferrer" class=footer__link-item>GitHub<svg width=13.5 height=13.5 aria-label="(opens in new tab)" class=iconExternalLink_nPIU><use href=#theme-svg-external-link /></svg></a><li class=footer__item><a href=https://github.com/cosmicstack-labs/mercury-agent/issues target=_blank rel="noopener noreferrer" class=footer__link-item>Issues<svg width=13.5 height=13.5 aria-label="(opens in new tab)" class=iconExternalLink_nPIU><use href=#theme-svg-external-link /></svg></a><li class=footer__item><a href=https://skills.mercuryagent.sh target=_blank rel="noopener noreferrer" class=footer__link-item>Skills registry<svg width=13.5 height=13.5 aria-label="(opens in new tab)" class=iconExternalLink_nPIU><use href=#theme-svg-external-link /></svg></a><li class=footer__item><a href=https://www.npmjs.com/package/@cosmicstack/mercury-agent target=_blank rel="noopener noreferrer" class=footer__link-item>npm<svg width=13.5 height=13.5 aria-label="(opens in new tab)" class=iconExternalLink_nPIU><use href=#theme-svg-external-link /></svg></a></ul></div></div><div class="footer__bottom text--center"><div class=footer__copyright>© 2026 Cosmic Stack · Mercury Agent is MIT-licensed open source.</div></div></div></footer></div></body>