Install
npm install -g @remnic/cli && remnic init && remnic daemon start && remnic statusPara 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:
- Pré-requisito: instalar o Node.js 22.12 ou versão mais recente (nodejs.org).
- 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.
- 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.