mercury-agent
Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI or Telegram.
Mercury Agent is a permission-hardened, autonomous AI agent that runs continuously from the command line, Telegram, or web interface. It features a structured Second Brain memory system powered by SQLite, token budget management, and 31 built-in tools for filesystem operations, shell commands, Git workflows, and web access. The agent asks for permission before executing sensitive operations, remembers user preferences and context across sessions, and supports extensible skills from a community registry with 126+ available skills.
Key Features
Use Cases
- 01Running a personal AI assistant 24/7 that remembers your preferences, goals, and project context across sessions
- 02Automating recurring development tasks with scheduled cron jobs that execute shell commands and file operations
- 03Managing multi-user team access to an AI agent via Telegram with role-based permissions and approval workflows
- 04Building a knowledge base that auto-extracts facts from conversations and surfaces relevant context in future chats
- 05Extending agent capabilities by installing community skills for web search, prompt engineering, and specialized workflows
- 06Coordinating complex tasks through Kanban boards where the agent autonomously processes cards in dependency order
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
mercury-agent — FAQ
What is Mercury Agent?+
Mercury Agent is a standalone autonomous AI agent that runs continuously on your machine with built-in memory, permission controls, and multi-channel access. It operates from the command line, Telegram, or a web dashboard and includes 31 tools for filesystem, shell, Git, and web operations.
How do I install Mercury Agent?+
Use the one-liner installer for your OS (curl on macOS/Linux or irm on Windows from mercuryagent.sh), or install via npm with 'npm i -g @cosmicstack/mercury-agent'. The first run triggers a setup wizard for name, LLM provider, and optional Telegram configuration.
Which LLM providers does Mercury support?+
Mercury supports DeepSeek (default), OpenAI (GPT-4o, o3), Anthropic (Claude Sonnet, Haiku, Opus), Grok (xAI), Ollama Cloud, and local Ollama. It automatically falls back to the next provider if one fails.
What API keys or prerequisites are required?+
You need Node.js 20+ (or use the standalone binary which bundles the runtime) and at least one LLM provider API key (DEEPSEEK_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, GROK_API_KEY, or OLLAMA_CLOUD_API_KEY). Telegram setup requires a bot token from @BotFather.
Is Mercury Agent free to use?+
Mercury Agent itself is open-source under the MIT license and free to use. You pay only for the LLM API usage from your chosen provider (DeepSeek, OpenAI, Anthropic, etc.).
How does the permission system work?+
Mercury asks for approval before executing sensitive operations like shell commands or file writes. You choose 'Ask Me' or 'Allow All' mode per session, with a built-in blocklist preventing dangerous commands like 'sudo' or 'rm -rf /' from ever executing.
How do I install mercury-agent?+
Open the source repository on GitHub and follow its README. mercury-agent is a agent — MCP Agents Market links you directly to the official repo.
Is mercury-agent free?+
mercury-agent is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.