O que llm-wiki-memory faz?
Memória local com versionamento Git para agentes de IA de codificação. Sem RAG, Docker ou serviços externos. Capture, compile e recupere informações em uma wiki local para LLMs com embeddings no dispositivo e um servidor MCP.
Visão Geral
Este skill fornece uma maneira leve e eficiente para agentes de IA lembrarem de informações complexas entre sessões de codificação. Ele utiliza uma wiki local no formato Markdown, com versionamento Git e embeddings gerados no dispositivo para permitir recuperação semântica. Nenhum serviço externo, banco de dados ou arquitetura de RAG é necessário.
Como Funciona
- Captura: O agente de IA registra fatos, decisões e snippets de código formatados como verbetes de wiki em um repositório local Git.
- Compilação: O sistema indexa automaticamente os verbetes, gerando embeddings usando um modelo local (via Transformers.js ou similar) e armazenando os embeddings em um arquivo JSON dentro do repositório Git.
- Recuperação: Quando o agente precisa lembrar de algo, ele envia uma consulta. O servidor MCP busca os verbetes mais relevantes por similaridade de cosseno entre o embedding da consulta e os embeddings armazenados, retornando os resultados em Markdown.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex (ou qualquer agente que suporte MCP)
Requisitos
- Node.js >= 18
- Git
- Modelo de embedding local (baixado automaticamente na primeira execução)
Instalação
npx llm-wiki-memory install
Este comando configura o repositório da wiki, instala dependências e cria o servidor MCP.
Configuração
As variáveis de ambiente podem ser configuradas no arquivo .env na raiz do skill:
| Variável | Descrição | Padrão |
|---|---|---|
WIKI_PATH | Caminho para o repositório da wiki | ./wiki |
EMBEDDING_MODEL | Nome do modelo de embedding local | Xenova/all-MiniLM-L6-v2 |
MCP_PORT | Porta para o servidor MCP | 8080 |
Uso
Ferramentas MCP
O skill expõe as seguintes ferramentas via MCP:
write_memory: Cria ou atualiza um verbete na wiki. Parâmetros:title: Título do verbetecontent: Corpo do verbete em Markdown
recall_memory: Recupera verbetes por consulta semântica. Parâmetros:query: Texto da consultalimit(opcional): Número máximo de resultados (padrão: 5)
list_memories: Lista todos os títulos de verbetes na wiki.delete_memory: Remove um verbete pelo título.
Exemplo de Prompt
Lembre-se da configuração de autenticação que fizemos no projeto.
O agente então chamará recall_memory com a consulta "configuração de autenticação" e recuperará os verbetes relevantes.
Versionamento Git
Cada alteração na wiki é automaticamente commitada com uma mensagem descritiva. Você pode revisar o histórico, fazer diff entre versões e reverter mudanças usando comandos Git padrão.
cd wiki
git log --oneline
git diff HEAD~1
Licença
MIT