Mercury Agent: The AI That Works While You Sleep
Mercury Agent is a soul-driven, permission-hardened AI that keeps working from your terminal, Telegram, or Discord even after you close your laptop.
Mercury Agent is an open-source AI agent that runs 24/7 on your machine, with memory, token budgets, and permission controls. Small businesses can use it to automate tasks like file management, code shipping, and web research without constant oversight.
What Is Mercury Agent?
Mercury Agent is an open-source AI agent that lives on your machine. It runs 24/7 from your terminal, Telegram, Discord, Slack, or Signal, and it remembers what matters. Unlike many AI tools that stop when you close your laptop, Mercury keeps working as a single background process you own.
According to its GitHub repository, Mercury has about 50 built-in tools for tasks like reading and writing files, running commands, shipping code through git and GitHub, researching the web, and keeping a schedule. Every action is checked against rules you set, and every turn stays inside a daily token budget.
The agent is designed to be “soul-driven,” meaning you can define its personality using plain Markdown files—soul.md, persona.md, taste.md, and heartbeat.md. This makes it adaptable to your business’s tone and workflows.
How It Works for Small Businesses
For a small business owner, Mercury Agent acts like a reliable virtual assistant that never clocks out. You can install it with one line—no Node.js required—on macOS, Linux, Windows, or even Android via Termux. The installer downloads a standalone binary and verifies its checksum.
Once installed, you run `mercury` to start a setup wizard where you enter your name, the agent’s name, API keys, and optional channels like Telegram. Mercury then starts its background service and opens a terminal UI. You can chat with it from anywhere—terminal, Telegram, Discord, Slack, or Signal—and it always connects to the same agent with the same memory.
The agent’s memory is stored locally in a SQLite file under ~/.mercury. It extracts durable facts like preferences, goals, projects, and decisions, with confidence scores, and recalls them before answering. You can inspect, pause, or clear this memory at any time using the /memory command.
Key Features That Matter to Small Businesses
Mercury Agent includes several features that directly benefit small businesses. First, it has permission-hardened tools: file access is scoped per folder, shell commands pass through a blocklist and an approval step, and outbound requests are checked against private address ranges. You can choose per session whether Mercury asks every time or runs freely.
Second, it enforces a daily token budget. When usage climbs, Token Saver mode trims context and can route routine work to a cheaper model. The /budget command shows your current usage. This helps control costs, especially if you’re using paid API models.
Third, Mercury Code turns the agent into a careful pair programmer inside your repository. It plans and builds in one flow, shows a live checklist, asks once before large changes, and only reports success after a build, test, or typecheck passes. For businesses that ship software, this reduces errors and saves time.
Fourth, Mercury Bots are persistent specialists with their own persona, model, memory, permissions, and daily budget. They run on schedules, hand work to each other, and deliver finished files to ~/Documents/Mercury/Bot name/. You can manage the whole fleet from Telegram with buttons.
Real-World Use Cases
A small business could use Mercury Agent to automate daily tasks like monitoring customer inquiries, scheduling social media posts, or running routine data backups. Because it runs 24/7 from a background daemon with crash recovery, you don’t need to keep a computer on—it just works.
For example, you could set up a Mercury Bot to research competitors every morning and drop a summary into your Telegram chat. Another bot could handle code reviews and only notify you when tests pass. The agent’s memory means it learns your preferences over time, reducing the need for repeated instructions.
The agent is also designed to be safe. It has a shell blocklist, per-folder read/write scopes, approval prompts, SSRF-guarded fetches, and secret redaction in logs. This is critical for businesses handling sensitive data.
Getting Started
To get started, visit the Mercury Agent website at mercuryagent.sh. The one-line installer works on macOS and Linux via curl, and on Windows via PowerShell. If you prefer npm, you can use `npm i -g @cosmicstack/mercury-agent` on Node.js 22 or newer.
After installation, run `mercury` to start the setup wizard. You can then use commands like `mercury code .` to open Mercury Code in your current repository, `mercury doctor` to change providers or keys, and `mercury status` to see what’s running. Upgrades are one command: `mercury upgrade`.
The agent supports multiple models including DeepSeek, OpenAI, Anthropic, Grok, Ollama, LM Studio, and any OpenAI-compatible endpoint, with automatic fallback. This flexibility lets you choose the best model for your budget and tasks.
Takeaways
- Mercury Agent runs 24/7 from a single background process, accessible via terminal, Telegram, Discord, Slack, or Signal, with memory that stays on your disk.
- It includes permission-hardened tools, a daily token budget, and a personality you can customize—making it safe and cost-effective for small businesses.
- Mercury Code and Mercury Bots extend its capabilities to automated code review and persistent task specialists that work on schedules.
Where would this work in your business?
Take the two-minute AI Opportunity Snapshot and we will point to where automation is most likely to pay off for you.