# Mercury Agent: A Soul-Driven AI with Hardened Permissions and Multi-Channel Access

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/cosmicstack-labs-mercury-agent
Generated for open source discovery and AI-assisted research.

Mercury Agent is a sophisticated, soul-driven AI agent designed for continuous 24/7 operation, offering robust permission-hardened tools, intelligent token budgeting, and versatile multi-channel access. It remembers what matters, asks for permission before acting, and runs seamlessly from the CLI, Telegram, or a web dashboard. With 31 built-in tools, Kanban boards, and a SQLite-backed Second Brain memory, Mercury provides a comprehensive and secure AI assistant experience.

GitHub: https://github.com/cosmicstack-labs/mercury-agent
OSRepos URL: https://osrepos.com/repo/cosmicstack-labs-mercury-agent

## Summary

Mercury Agent is a sophisticated, soul-driven AI agent designed for continuous 24/7 operation, offering robust permission-hardened tools, intelligent token budgeting, and versatile multi-channel access. It remembers what matters, asks for permission before acting, and runs seamlessly from the CLI, Telegram, or a web dashboard. With 31 built-in tools, Kanban boards, and a SQLite-backed Second Brain memory, Mercury provides a comprehensive and secure AI assistant experience.

## Topics

- ai-agent
- ai-assistant
- llm
- TypeScript
- open-source
- developer-tools
- automation

## Repository Information

Last analyzed by OSRepos: Wed Aug 12 2026 12:30:03 GMT+0100 (Western European Summer Time)
Detail views: 0
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Mercury Agent is a sophisticated, soul-driven AI agent developed by cosmicstack-labs, designed for continuous 24/7 operation. It offers a unique blend of permission-hardened tools, intelligent token budgeting, and versatile multi-channel access, including CLI, Telegram, and a dedicated web dashboard. Mercury remembers crucial information, always seeks permission before executing actions, and integrates 31 built-in tools, Kanban boards, extensible skills, and a SQLite-backed Second Brain memory for a truly comprehensive AI assistant experience.

## Installation

Getting started with Mercury Agent is straightforward. The recommended method involves a simple one-liner script that downloads the latest standalone binary for your operating system, requiring no prior Node.js installation.

**For macOS / Linux:**
bash
curl -fsSL https://mercuryagent.sh/install.sh | sh


**For Windows:**
powershell
irm https://mercuryagent.sh/install.ps1 | iex


Alternatively, if you have Node.js 20+ installed, you can use npm:
bash
npx @cosmicstack/mercury-agent


Upon first run, Mercury will guide you through a setup wizard to configure your agent's name, provider, and optional Telegram integration. You can reconfigure settings at any time using the `mercury doctor` command.

## Examples

Mercury Agent provides a rich set of commands for interaction, both from the command line and directly within chat conversations.

**CLI Commands:**
*   `mercury up`: Installs the service, starts the daemon, and ensures Mercury is running persistently.
*   `mercury doctor`: Reconfigure setup, including name, providers, channels, and permissions.
*   `mercury upgrade`: Upgrade Mercury to its latest version.
*   `mercury skills install <id>`: Install community-contributed skills from the registry.

**In-Chat Commands (CLI and Telegram):**
*   `/help`: Display the full manual for in-chat commands.
*   `/status`: Show agent configuration, budget, and usage statistics.
*   `/budget`: Check your daily token budget status, override it for a request, or reset usage.
*   `/permissions`: Change the agent's permission mode between "Ask Me" and "Allow All".
*   `/memory`: View and manage your Second Brain memory.

## Why Use Mercury Agent?

Mercury Agent stands out with several core principles that enhance its utility and security:

*   **Permission-hardened**: It prioritizes security by implementing a shell blocklist, folder-level read/write scoping, and a pending approval flow, ensuring no actions are taken without explicit consent.
*   **Second Brain**: Features a persistent, structured memory powered by SQLite + FTS5, enabling Mercury to learn your preferences, goals, and habits automatically without manual entry.
*   **Soul-driven**: Its personality is defined by markdown files you own, such as `soul.md` and `persona.md`, offering a truly personalized AI experience free from corporate wrappers.
*   **Token-aware**: Enforces daily token budgets, automatically becoming concise when usage is high, and provides commands to manage your budget.
*   **Live streaming**: Offers real-time token streaming on the CLI with cursor-save/restore and markdown re-rendering, and editable status messages on Telegram.
*   **Always on**: Can run as a background daemon on any OS, with auto-restarts on crashes, starting on boot, and proactive notifications.
*   **Extensible**: Supports installing community skills with a single command, based on the Agent Skills specification, allowing for broad functionality expansion.

## Links

*   **GitHub Repository**: [https://github.com/cosmicstack-labs/mercury-agent](https://github.com/cosmicstack-labs/mercury-agent){target="_blank" rel="noopener noreferrer"}
*   **NPM Package**: [https://www.npmjs.com/package/@cosmicstack/mercury-agent](https://www.npmjs.com/package/@cosmicstack/mercury-agent){target="_blank" rel="noopener noreferrer"}
*   **Skills Registry**: [https://skills.mercuryagent.sh](https://skills.mercuryagent.sh){target="_blank" rel="noopener noreferrer"}
*   **Discord Community**: [https://discord.gg/5emMpMJy5J](https://discord.gg/5emMpMJy5J){target="_blank" rel="noopener noreferrer"}