cosmicstack-labs

cosmicstack-labs / mercury-agent

Public

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI or Telegram.

mercury.cosmicstack.org ai-agent ai-assistant llm
32
3
100% credibility
Found Apr 20, 2026 at 32 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Mercury Agent is a personal AI assistant that runs persistently via terminal or Telegram, handles file operations, shell commands, git tasks, and scheduling with built-in safety permissions and token budgeting.

How It Works

1
🔍 Discover Mercury

You hear about Mercury, a friendly AI helper that manages files, runs safe commands, and schedules tasks on your computer or phone.

2
🚀 Try it quickly

You run a simple command to start it, and it welcomes you with a fun setup wizard that takes just 30 seconds.

3
🧑‍💻 Set your personality

You share your name, connect a smart AI brain, and optionally link your Telegram for chatting anywhere – now it's your personal assistant.

4
💬 Start chatting

You type messages like 'list my files' or 'schedule a daily reminder', and Mercury responds helpfully while always asking before making changes.

5
🛡️ Safe and smart actions

Mercury reads files, runs commands, or updates git safely – it blocks dangers, approves with you, and tracks spending to stay efficient.

6
⏰ Set up reminders

You ask it to schedule tasks that run automatically, like daily check-ins, and it notifies you across chat or terminal.

✨ Your always-on helper

Mercury runs 24/7, remembers your style, grows with custom skills, and makes your daily tasks easier and more fun.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 32 to 32 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mercury-agent?

Mercury-agent is a soul-driven AI agent built in TypeScript for Node.js that gives you a personal assistant for dev tasks like file edits, git ops, shell commands, and web fetches. It runs 24/7 as a daemon via CLI or Telegram with multi-channel access, using permission-hardened tools that always ask before acting on sensitive stuff like deletes or pushes. Setup takes 30 seconds with a wizard for API keys, and it enforces token budgets across providers like OpenAI, Anthropic, or DeepSeek.

Why is it gaining traction?

Unlike cloud agents that silently nuke your repo or burn cash, mercury-agent blocks dangerous commands (sudo, rm -rf), scopes file access, and prompts for approval—zero surprises. Token budgets auto-concise responses over 70% used, and daemon mode auto-restarts with boot-start services on macOS/Linux/Windows. Extensible skills and cron scheduling make it stick for recurring tasks, all from simple CLI commands like `mercury up`.

Who should use this?

Solo devs handling git workflows, file tweaks, or shell automation without babysitting. Perfect for those scripting reminders ("daily at 9am check logs") or needing a Telegram-accessible agent for quick fixes on the go. Avoid if you want zero local setup—it's for tinkerers who value control over hosted services.

Verdict

Early stage with 32 stars and 1.0% credibility score, but solid README and MIT license make it worth a spin for personal use. Test in a sandbox; maturity shows in daemon reliability, though skills ecosystem is nascent.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.