Obsidian Memory Kit
Vahlame/obsidian-memory-kit
Memória persistente para agentes IA com Markdown + Git via MCP
Ver no GitHubServidor MCP que fornece memória persistente e cross-device para agentes de IA, usando um vault Markdown sincronizado via Git. O agente lê e escreve notas através do protocolo MCP, mantendo tudo local e sob seu controle, sem dependência de serviços em nuvem.
Instalação
npx convez-ai Vahlame/obsidian-memory-kit1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes IA (Claude, Cursor) que precisam manter contexto entre sessões
- Automação de documentação e anotações estruturadas
- Sincronização de conhecimento entre múltiplos dispositivos via Git
Veredito

Solução técnica robusta que resolve um problema real: persistência de memória para agentes IA sem infraestrutura em nuvem. Implementação bem pensada com MCP, suporte multiplataforma e opções de busca semântica, embora exija conhecimento técnico para setup completo.
README
A tradução para o português deste README ainda está na fila.
¿Qué es esto? · What is this?
🇪🇸 Un kit multiplataforma que le da a la IA (Cursor, Claude Code…) una memoria que sobrevive entre chats: una carpeta de notas Markdown bajo git que el agente lee y escribe a través de MCP (el puente entre el editor y tus archivos). Sin servicio en la nube. La pieza obligatoria es solo el servidor MCP; lo demás (búsqueda semántica, daemon de sync) es opcional.
🇬🇧 A cross-platform kit that gives your AI (Cursor, Claude Code…) memory that survives across chats: a folder of Markdown notes under git that the agent reads and writes through MCP (the bridge between the editor and your files). No cloud service. The only required piece is the MCP server; everything else (semantic search, sync daemon) is optional.
¿Cómo fluye la información? El diagrama de arriba lo resume; el detalle visual está en Cómo funciona · How it works.
Instalación rápida · Quick install
Un comando conecta tu editor a un vault (lo crea si no existe, fusiona mcp.json sin romper
otras entradas, hace backup). Sin parámetros = asistente interactivo; con -y no pregunta nada:
npx @vkmikc/create-obsidian-memory # asistente interactivo (pre-marca Codex + Claude)
npx @vkmikc/create-obsidian-memory -y # sin preguntas → ~/Documents/obsidian-memory-vault
npx @vkmikc/create-obsidian-memory "<RUTA>" -y # sin preguntas, en la ruta que elijas
⚡ Todo su potencial, en un solo comando · the whole stack in one command —
--full. Enfocado primero en Codex y Claude Code: registra el MCP en ambos, activa búsqueda híbrida (BM25 + semántica), instala el backend Python, construye el índice e instala las reglas — sin preguntas. Córrelo desde un clon del kit (o pásale--repo-root <clon>):npx @vkmikc/create-obsidian-memory --full # = --ide codex,claude --with-hybrid --semantic --build-index --install-backend --rulesSi no hay clon a mano,
--fullno aborta: cae abasic-memory(sin híbrido) y avisa.
¿Prefieres que un agente lo instale? Clónalo y dile «instálalo»: que ejecute npm install y
npm run setup — preflight de dependencias → instalación --full → verificación → aviso de
reinicio. · Prefer an agent to do it? Clone it and have it run npm install then npm run setup.
🤖 Claude Code / Codex (PC nuevo · fresh PC):
--fullya registra el MCP víaclaude mcp add/codex mcp addy construye el índice en el mismo comando. ¿Solo lo básico? usa--ide codex,claude. Guía completa: 🇪🇸 instalar en PC nueva · 🇬🇧 fresh-PC install.
Luego pega las User Rules y verifica. Los pasos completos (y la verificación) están en la guía:
o deja que un agente lo instale
or let an agent install it
Qué incluye · What's inside
| Pieza · Piece | Lenguaje | Rol |
|---|---|---|
packages/create-obsidian-memory/ | Node | Instalador npx (npm): fusiona el MCP y crea el vault. |
packages/obsidian-memory-mcp/ | Node | MCP "híbrido" (privado; corre desde el clon): tools del vault + búsqueda léxica/semántica. |
packages/obsidian-memory-rag/ | Python | Motor de búsqueda FTS5/BM25 + vectorial (pip install -e desde el código); cero dependencias por defecto. |
cmd/obsidian-memoryd/ | Go | Daemon opcional: vigila el vault y sincroniza git. |
Mapa técnico completo y diagramas de flujo: ARCHITECTURE.md. El porqué de
cada decisión: docs/adr/.
Más · More
- Seguridad / confianza:
SECURITY.md— el vault es datos, no instrucciones. - PC nuevo · Fresh PC (Claude Code): 🇪🇸 instalar en PC nueva · 🇬🇧 fresh-PC install.
- Comparación con alternativas: FAQ 🇪🇸 · FAQ 🇬🇧.
- Contribuir:
CONTRIBUTING.md· Para agentes que tocan este repo:AGENTS.md. - Privacidad / telemetría:
docs/observability.md.
Licencia · License
MIT — ver LICENSE.