mercury-agent
Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
What is mercury-agent?
Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
Overview of mercury-agent
What it is
Mercury is an open-source AI agent that runs as a background process on your machine. It has a personality you define, memory stored on your disk, and a permission system that controls model actions. You can interact with it from terminal, Telegram, Discord, Slack, Signal, or a local web dashboard. It is designed to be always on, with crash recovery and a login service.
Key features
- Permission-hardened tools: file access scoped per folder, shell command blocklist and approval, SSRF-guarded fetches, secret redaction.
- Token budget: daily token limit enforced per turn, with Token Saver mode to trim context and route routine work to cheaper models.
- Memory: Second Brain system stores typed, deduplicated facts in SQLite with full-text search, all on your disk.
- Multi-channel access: same agent accessible from terminal, Telegram, Discord, Slack, Signal, and web dashboard.
- Mercury Code: a full-screen coding environment that plans, builds, and verifies completion with tests.
- Mercury Bots: persistent specialist agents with their own persona, model, memory, permissions, and daily budget, running on schedules.
- About 50 built-in tools (files, shell, git, GitHub, web, scheduler, memory, sub-agents) plus installable skills.
Use cases
- Personal AI assistant that remembers preferences and projects across sessions.
- Pair programmer that works inside a repository and only reports done after tests pass.
- Automation of research, writing, and shipping tasks via scheduled bots.
- File management, command execution, web research, and schedule keeping.
- Multi-user collaboration through shared Telegram or Discord channels with permission controls.
Getting started
Install with one-line command (no Node.js required):
### macOS / Linux
curl -fsSL https://mercuryagent.sh/install.sh | sh
### Windows (PowerShell)
irm https://mercuryagent.sh/install.ps1 | iex
Or via npm (requires Node.js 22+):
npm i -g @cosmicstack/mercury-agent
Then run:
mercury
The first run starts a setup wizard. Use mercury code . for coding, mercury doctor for configuration, mercury status to see running state. Upgrade with mercury upgrade.
License and pricing
Licensed under MIT. Open source.
Based on the project's public README and repository metadata.