Memnest

Memória local-first para agentes de codificação, com busca híbrida e acesso via MCP.

Documentação

memnest

한국어 | Instalação | Como usar | Operações

Memória local para encontrar o que você fez com uma IA de codificação e por que decidiu fazê-lo.

O Memnest armazena textos de conversas do pi, Claude Code e Codex na sua máquina. As IAs conectadas podem pesquisar esses registros e ler a fonte após o término da sessão. Conecte vários clientes ao mesmo serviço Memnest para usar o mesmo histórico.

Quando usar

Use o registro acumulado para perguntas como:

Por que trocamos de gerenciador de tarefas? Encontre a discussão por trás dessa decisão.

Qual abordagem de implantação definimos por último para este projeto e por quê?

O que tentamos da última vez que esse erro aconteceu?

A IA pesquisa a memória, lê a fonte relevante e a usa para responder. Os resultados incluem IDs de fonte para que você possa verificar as evidências. Estes são exemplos de solicitações, não uma demonstração autônoma ou uma garantia de que uma resposta será encontrada.

Para algumas regras que devem ser aplicadas sempre, AGENTS.md ou CLAUDE.md é mais simples. O Memnest é para um histórico crescente de conversas e decisões que você deseja consultar quando necessário.

Instalação

Arquivos Linux x86_64 e Arm64 estão disponíveis; Rust não é necessário. A primeira gravação ou pesquisa baixa um modelo de incorporação de cerca de 1,1 GB. A incorporação pode usar cerca de 1,9 GB de RAM.

Leia o script baixado antes de executá-lo. Antes de atualizar uma instalação existente, faça backup de memory.db junto com master.key.

curl -fsSL https://raw.githubusercontent.com/Blue-B/memnest/v0.3.1/core/scripts/install.sh \
  -o /tmp/memnest-install.sh
VERSION=v0.3.1 bash /tmp/memnest-install.sh --user

A configuração inicia o servidor e o observador de conversas e adiciona conexões ausentes às configurações suportadas do Claude Code, Codex e Cursor. Ela faz backup da configuração existente antes de alterá-la e imprime comandos de recuperação.

Conectar o pi

Com o núcleo em execução, instale a extensão correspondente:

pi install npm:pi-memnest@0.3.1

Se o Memnest já estiver registrado de outra fonte, remova esse registro primeiro para evitar carregá-lo duas vezes. Use /memnest no pi para verificar a conexão. Consulte configurações da extensão.

Outros clientes MCP se conectam a http://127.0.0.1:3111/mcp. Consulte exemplos de conexão, outros ambientes e instalação a partir da fonte e atualização e recuperação. macOS é somente fonte; instalação e remoção nativas não foram validadas.

Como usar

Peça à sua IA conectada para consultar uma conversa ou decisão anterior. A recuperação automática está desativada por padrão; você pode começar solicitando uma pesquisa quando precisar. Consulte configurações da extensão para ativar a recuperação automática.

Clientes que chamam ferramentas diretamente usam este fluxo:

memory_search(query="reason for switching task managers")
memory_get(id="<ID returned by search>")

Cinco ferramentas cobrem salvar, pesquisar, ler, corrigir e excluir. Use memory_remember para salvar explicitamente uma decisão importante. Quando um fato mudar, salve sua substituição com supersedes=<old ID> para vinculá-la ao registro anterior.

Quando o host fornece o diretório atual, as pesquisas incluem esse espaço de trabalho e o playbook compartilhado. Especifique project=all para uma pesquisa deliberada entre projetos. Consulte leitura de fonte para registros longos e entradas de conversa próximas.

Conversas anteriores à instalação não são importadas automaticamente. Selecione os arquivos originais necessários com importação de histórico.

Limitações importantes

A recuperação não é verificação de verdade. A pesquisa pode não encontrar um registro relevante. O Memnest não pode determinar se uma decisão antiga ainda é válida. Uma dica de fonte seguinte não é uma relação de resposta verificada.
A captura é seletiva. Ela armazena texto visível de conversa, não raciocínio, tráfego de ferramentas, imagens ou conversas de subagentes. Ela não importa a memória integrada do ChatGPT ou do Claude.
O armazenamento é local; sua IA conectada responde. O Memnest não faz chamadas generativas de LLM. Um provedor de IA em nuvem recebe o texto recuperado que você envia ao seu modelo.
Memórias regulares não são criptografadas. A redação lida com padrões conhecidos de credenciais, não com todos os segredos possíveis. Não exponha a porta 3111 diretamente à internet.
A exclusão não é apagamento imediato. Os registros permanecem na lixeira por 30 dias e podem permanecer no JSONL de arquivo. Consulte limites de segurança e exclusão.

Documentação e verificações

Um serviço Rust armazena registros de fonte no SQLite e pesquisa com BM25 mais incorporações multilíngues locais. Os índices de pesquisa podem ser reconstruídos a partir dos registros de fonte.