Repolode
cosmicstack-labs

cosmicstack-labs/mercury-agent

Agente de IA auto-hospedado, com memória local, ferramentas sujeitas a permissões e acesso por CLI, Telegram, Discord ou Slack.

Estrelas
3,881
Forks
399
Issues abertas
20
Último commit
ontem

O que é?

O Mercury Agent é um agente de IA em TypeScript que roda como um único processo em segundo plano na sua máquina — macOS, Linux, Windows ou Android via Termux. Ele é instalado como um serviço de login, reinicia após uma falha e oferece o mesmo agente e a mesma memória pelo terminal, Telegram, Discord, Slack, Signal ou por um painel web local vinculado a 127.0.0.1.

O que ele acrescenta às ferramentas comuns de arquivos, shell e web é uma camada de governança: uma lista fixa de comandos de shell bloqueados que não pode ser sobrescrita, permissões de leitura e gravação por pasta, solicitações de aprovação, requisições protegidas contra SSRF e remoção de segredos dos logs. O Second Brain armazena fatos tipados e deduplicados em um banco de dados SQLite local, com busca de texto completo, e recupera os fatos relevantes antes de cada resposta. Além disso, um limite diário de tokens restringe cada interação. Há fallback entre provedores como DeepSeek, OpenAI, Anthropic, Ollama, LM Studio e qualquer endpoint compatível com OpenAI.

Dois modos ampliam os recursos principais: o Mercury Code planeja e desenvolve dentro de um repositório e só informa que uma tarefa foi concluída quando um build, teste ou typecheck passa; já o Mercury Bots oferece especialistas persistentes, com persona, permissões e orçamento próprios, que rodam em horários programados e entregam os arquivos finalizados em uma pasta local. O pacote inclui cerca de 50 ferramentas, além de skills da comunidade que podem ser instaladas e um agendador no estilo cron.

Recursos principais

  • 01Camada de permissões com lista fixa de comandos de shell bloqueados, permissões de leitura e gravação por pasta, modos Ask Me ou Allow All por sessão e busca de URLs protegida contra SSRF.
  • 02Memória Second Brain: dez tipos de fatos extraídos automaticamente para um banco de dados SQLite local, com busca de texto completo, consolidação a cada hora e inspeção por `/memory`.
  • 03Acesso multicanal a um único runtime pelo terminal, Telegram, Discord, Slack, Signal e painel web em localhost com chat, Kanban e painel de controle dos bots.
  • 04O Mercury Code trabalha em um repositório com um plano atualizado em tempo real e só marca as tarefas como concluídas depois que um build, teste ou typecheck passa.
  • 05O Mercury Bots funciona como especialistas persistentes e agendados, individualmente ou em grupos com tarefas delegadas, orçamentos por bot e entrega de arquivos.
  • 06Fallback entre DeepSeek, OpenAI, Anthropic, Grok, Ollama, LM Studio e qualquer endpoint compatível com OpenAI, além de um limite diário de tokens com o modo Token Saver.
  • 07Cerca de 50 ferramentas integradas para arquivos, shell, git, GitHub, agendamento, subagentes e Spotify, com skills instaláveis em skills.mercuryagent.sh.

Casos de uso

  • Usar um assistente pessoal que mantém a própria memória e continua trabalhando mesmo depois que você fecha o laptop.
  • Permitir que um agente edite código em um repositório com solicitações de aprovação e verificação antes de informar que terminou.
  • Acessar um único agente por um canal compartilhado do Telegram ou Discord, com permissões por função para administradores e membros.
  • Agendar tarefas recorrentes de pesquisa ou geração de relatórios que entregam arquivos em uma pasta local ou no chat.
  • Manter prompts, chaves e dados de conversas no seu próprio disco, em vez de usar um serviço hospedado.

Início rápido

  1. 1

    Instale via npm (Node.js 22 ou superior)

    npm i -g @cosmicstack/mercury-agent
  2. 2

    Execute o Mercury e conclua o assistente de configuração

    mercury

Antes de usar

  • Os scripts de instalação são transmitidos pela web, então o instalador de uma linha exige que você confie em um script externo.
  • As skills da comunidade não são auditadas e devem ser revisadas antes da instalação.
  • Para usar todos os recursos, é necessário ter chaves de API de um provedor de LLM ou uma conta do Mercury Cloud.

Em coleções

Tópicos

Perguntas frequentes

O que é mercury-agent?
Agente de IA auto-hospedado, com memória local, ferramentas sujeitas a permissões e acesso por CLI, Telegram, Discord ou Slack. O Mercury Agent é um agente de IA em TypeScript que roda como um único processo em segundo plano na sua máquina — macOS, Linux, Windows ou Android via Termux. Ele é instalado como um serviço de login, reinicia após uma falha e oferece o mesmo agente e a mesma memória pelo terminal, Telegram, Discord, Slack, Signal ou por um painel web local vinculado a 127.0.0.1.
mercury-agent é gratuito? Qual é a licença?
mercury-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mercury-agent ainda é mantido?
Manutenção ativa. O último commit de mercury-agent foi em 6 de nov. de 2026.
Para que posso usar mercury-agent?
Usar um assistente pessoal que mantém a própria memória e continua trabalhando mesmo depois que você fecha o laptop. Permitir que um agente edite código em um repositório com solicitações de aprovação e verificação antes de informar que terminou. Acessar um único agente por um canal compartilhado do Telegram ou Discord, com permissões por função para administradores e membros. Agendar tarefas recorrentes de pesquisa ou geração de relatórios que entregam arquivos em uma pasta local ou no chat. Manter prompts, chaves e dados de conversas no seu próprio disco, em vez de usar um serviço hospedado.
Como instalar mercury-agent?
Instale via npm (Node.js 22 ou superior): npm i -g @cosmicstack/mercury-agent Execute o Mercury e conclua o assistente de configuração: mercury
Onde consigo mercury-agent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cosmicstack-labs/mercury-agent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados