MCP

Remnic: uma base de memória compartilhada e local-first para seus agentes de IA

Melhor para montar uma base de memória compartilhada, transparente e rastreável para vários agentes de IA locais, desde que você possa executar o Node.js 22.12+ e aceite que as memórias fiquem em texto claro como arquivos markdown no disco da sua máquina.

Official source · GitHub - joshuaswarren/remnic

Install

npm install -g @remnic/cli && remnic init && remnic daemon start && remnic status

Para quem é adequado

  • Para desenvolvedores individuais que querem dar aos seus assistentes de IA uma memória compartilhada entre sessões e entre vários agentes: as memórias são armazenadas como arquivos markdown comuns com YAML frontmatter no seu próprio disco, e o índice de busca pode ser reconstruído a partir desses arquivos, sem necessidade de serviços de banco de dados externos. Código aberto sob licença MIT, local-first.
  • Para cenários em que você usa vários agentes ao mesmo tempo e deseja "uma base de memória que todos os agentes possam usar"; além de armazenamento e recuperação, o conjunto de ferramentas MCP inclui busca de entidades, correção de memórias, recuperação por tempo, rastreamento de origem via X-ray, briefing diário, quadro de trabalho e ferramentas de continuidade.
  • Quando não é adequado: requer Node.js 22.12 ou versão mais recente; ambientes mais antigos não funcionam. O grau de suporte a implantação remota (docker, serviços hospedados etc.) não é indicado nas evidências; se você tiver esse tipo de necessidade, verifique por conta própria antes.

Primeira tentativa em 3 minutos

O caminho principal recomendado é o fluxo completo com a CLI oficial:

  1. Pré-requisito: instalar o Node.js 22.12 ou versão mais recente (nodejs.org).
  2. Instalar e inicializar:
npm install -g @remnic/cli
remnic init

O remnic init grava o arquivo de configuração remnic.config.json (escrita de estado local, parte normal da inicialização). A instalação global também instala o comando remnic, além do comando legado de encaminhamento engram.

  1. Iniciar e confirmar:
remnic daemon start
remnic status

Se o remnic status retornar normalmente, é o sinal de sucesso: o serviço em segundo plano está em execução e você pode conectar clientes. No modo autônomo, o daemon funciona como um endpoint HTTP que expõe as ferramentas MCP (oficialmente também há a opção de executar via @remnic/server, como escolha secundária). Para a primeira verificação, recomenda-se usar apenas ações de confirmação de estado como remnic status, antes de fazer armazenamentos reais.

Atenção à distinção: tanto o remnic init quanto as escritas de memória posteriores gravam no disco local e não são operações somente leitura; o remnic status é uma confirmação de baixo risco que apenas verifica o estado de execução.

Casos de uso

  • Caso: armazenar uma memória e depois recuperá-la. Com o daemon em execução, guarde um fato na base de memória e, em seguida, consulte-o por meio da capacidade de recuperação via MCP. Os registros de memória são arquivos markdown com YAML frontmatter no disco (com estruturas como category: decision); após o sucesso, você pode ver o registro diretamente nos arquivos locais e recuperá-lo pelo lado do agente. As evidências não fornecem exemplos dos parâmetros exatos de chamada das ferramentas store/recall; quanto aos parâmetros específicos, siga as descrições das ferramentas listadas pelo seu cliente MCP.
  • Caso: retomar o trabalho de ontem com o briefing diário / ferramentas de continuidade. Após conectar ao endpoint MCP, o cliente listará o conjunto de ferramentas do Remnic, que inclui as ferramentas daily briefing (briefing diário), work-board (quadro de trabalho) e continuity (continuidade); ao chamar a ferramenta de briefing, você obtém uma visão geral do estado atual com base nas memórias existentes. A grafia exata dos nomes das ferramentas deve ser verificada na lista exibida pelo cliente; as evidências não as listam uma a uma.

Limites de uso

  • O Remnic é um sistema local de leitura e escrita: armazenar memórias grava arquivos markdown no disco, e corrigir memórias modifica o conteúdo existente; as evidências não mencionam um caminho integrado de desfazer/rollback, portanto não deve ser considerado automaticamente reversível. Exclusão e backup dependem da sua gestão dos arquivos locais.
  • As memórias ficam em texto claro (markdown) no disco local; tenha cautela ao armazenar informações sensíveis. O README não traz, nas evidências, explicações específicas sobre privacidade e anonimização — desconhecido.
  • O serviço requer Node.js ≥ 22.12; detalhes como porta de conexão dos clientes e autenticação não foram divulgados nas evidências; se precisar expor pela rede, consulte primeiro a documentação oficial para confirmar.
  • Itens não confirmados (política de privacidade, parâmetros completos das ferramentas, implantação remota) devem ser verificados no README mais recente do repositório oficial.