Agent skill · software engineering · aradotso
mercury-agent-cosmicstack
mercury-agent-cosmicstack — an agent skill for coding agents.
Why this skill is useful
Adds executable CLI commands and configuration patterns for setting up and managing the Mercury AI agent, which are not commonly found in public documentation.
What it needs
Requires npm installed locally. Requires anthropic, deepseek, openai, telegram account access. About 7k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash One-shot via npx (no install required) npx @cosmicstack/mercury-agent Global install npm i -g @cosmicstack/mercury-agent mercury bash === Lifecycle === mercury up # Recommended: install service + start daemon + ensure running mercury # Start in foreground (same as mercury start) mercury start # Start in foreground mercury start -d # Start in background (daemon mode) mercury restart # Restart background process mercury stop # Stop background process === Diagnostics === mercury logs # View recent daemon logs mercury status # Show config and daemon status mercury doctor # Reconfigure (Enter to keep current values) mercury setup # Re-run setup wizard mercury help # Show full manual mercury --verbose # Start with debug logging === System Service (auto-start on boot) === mercury service install # Install as system service mercury service uninstall # Remove system service mercury service status # Check service status yaml providers: name: deepseek apiKey: $DEEPSEEKAPIKEY model: deepseek-chat name: openai apiKey: $OPENAIAPIKEY model: gpt-4o-mini name: anthropic apiKey: $ANTHROPICAPIKEY model: claude-3-haiku-20240307 channels: telegram: token: $TELEGRAMBOTTOKEN budget: dailyTokens: 100000 conciseThreshold: 0.7 # Switch to concise mode at 70% usage agent: name: Mercury soulDir: ~/.mercury/soul yaml filesystem: readPaths: ~/projects ~/Documents writePaths: ~/projects requireApproval: false shell: enabled: true requireApproval: true # Always ask before running shell commands blocklist: "sudo" "rm -rf /" "dd if=" "mkfs" web: fetchEnabled: true requireApproval: false /help Show the full manual /status Show agent config, budget, and usage /tools List all loaded tools /skills List installed skills /stream Toggle Telegram text streaming /stream off Disable streaming (single message delivery) /budget Show token budget status /budget override Override budget limit for one request /budget reset Reset usage counter to zero /budget set 50000 Change daily token budget to 50,000 token …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/mercury-agent-cosmicstack