Whq02/MercuryCLI

English |
简体中文 |
繁體中文 |
한국어 |
Deutsch |
Español |
Français |
Italiano |
Dansk |
日本語 |
Polski |
Русский |
Bosanski |
العربية |
Norsk |
Português (Brasil) |
ไทย |
Türkçe |
Українська |
বাংলা |
Ελληνικά |
Tiếng Việt
An agent reads and edits files, runs shell commands, steps through tests and debuggers, and checks the results while you choose the model provider, the model, and what the agent is allowed to do. Mercury is used to build Mercury across parallel sessions and models: each session writes a handoff note when it finishes, and the next session reads that note once at startup alongside your pinned rules, stopping context poisoning between sessions.
Mercury is open source under the Apache License 2.0, as are the SDKs in sdk/ and sdk-py/.
## Install
Release archives for Apple silicon and Intel Macs, Linux x64 and arm64, and Windows x64 and arm64 include Node and ripgrep (git is the only separate requirement):
sh
curl -fsSL https://mercury-cli.ai/install | sh # macOS and Linux (x64 and arm64)
irm https://mercury-cli.ai/install.ps1 | iex # Windows (x64 and arm64), in PowerShell 7
brew install Whq02/mercury/mercury # Homebrew: macOS and Linux x64
npm install -g mercury-tech-cli # npm; bun install -g mercury-tech-cli is the same package
mise use -g npm:mercury-tech-cli # mise, through the npm package
To run a Windows archive without installing it, extract it and run mercury\mercury.exe from PowerShell or Command Prompt. mercury.cmd and mercury.ps1 are also in that folder.
The install addresses keep approximate script-request counts by source and UTC day (completed installs are not counted); the counter stores no IP address, user-agent string or cookie. Open a new terminal (or run the export PATH=… line the shell installer prints), check mercury --version, and run mercury inside a repository. See docs/INSTALL.md, docs/INSTALL-WINDOWS-FROM-SOURCE.md and AGENTS.md for mercury update, release verification, requirements and building from source.
## What is inside
22 model providers, /llmhost and /localsetup: keep all 22 providers signed in at once (OpenAI, Anthropic, Google, DeepSeek, Moonshot, Z.AI, OpenRouter, Hugging Face, xAI, Meta, Mistral, Nous Portal, OpenCode Zen, Qwen, MiniMax, Together AI, Cohere, Groq, Cerebras, Fireworks AI, Melious AI, OrcaRouter, or your own local/hosted weights) and switch models mid-chat; new sessions default to your most recently connected provider. Rent or host weights with /llmhost and mercury host (docs/LLM-HOST.md), connect Ollama, LM Studio, vLLM or llama.cpp with /localsetup (docs/LOCAL-SETUP.md), and see docs/ENGINES.md for sign-ins and routing.
The daily loop, Session Concourse and crewmates: interactive launches open the home screen (New Session, Continue Last Session once session history exists, Boot Menu, MCPs & Skills, Agents, Health Check, Saturn Scheduler, Logins, Session Concourse, Sessions · Projects); run parallel sessions on /concourse and delegate to cross-provider crewmates (Crewmate) in isolated git worktree checkouts with project file leases (docs/SESSIONS.md, docs/CREW.md).
Headless CLI and JSON-RPC runner: run one-shot prompts with mercury run " " (--format text|json|rows, --input rows, --partial), or host multi-turn sessions over stdio with mercury runner and the TypeScript and Python SDKs (docs/AUTOMATION.md, sdk/, sdk-py/).