{"id":51371241,"url":"https://github.com/vahlame/obsidian-memory-kit","last_synced_at":"2026-07-03T07:01:32.192Z","repository":{"id":357523758,"uuid":"1237329141","full_name":"Vahlame/obsidian-memory-kit","owner":"Vahlame","description":"An operational prompt that lets an agent set up persistent, cross-device memory for itself using Obsidian MCP and a private GitHub vault on Windows.","archived":false,"fork":false,"pushed_at":"2026-07-01T19:53:13.000Z","size":7213,"stargazers_count":2,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-02T08:19:39.403Z","etag":null,"topics":["agent-memory","agents-md","ai-agents","github-sync","mcp","model-context-protocol","obsidian","persistent-memory","powershell","windows"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vahlame.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":[],"custom":[]}},"created_at":"2026-05-13T04:49:25.000Z","updated_at":"2026-07-01T19:52:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Vahlame/obsidian-memory-kit","commit_stats":null,"previous_names":["vahlame/cursor-obsidian-memory-guide","vahlame/obsidian-memory-kit"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Vahlame/obsidian-memory-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vahlame%2Fobsidian-memory-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vahlame%2Fobsidian-memory-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vahlame%2Fobsidian-memory-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vahlame%2Fobsidian-memory-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vahlame","download_url":"https://codeload.github.com/Vahlame/obsidian-memory-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vahlame%2Fobsidian-memory-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35075805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-memory","agents-md","ai-agents","github-sync","mcp","model-context-protocol","obsidian","persistent-memory","powershell","windows"],"created_at":"2026-07-03T07:00:38.931Z","updated_at":"2026-07-03T07:01:32.186Z","avatar_url":"https://github.com/Vahlame.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/hero.svg\" alt=\"Tu agente habla con servidores MCP, que leen y escriben notas Markdown en tu vault git; un daemon opcional sincroniza con un remoto\" width=\"840\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e🧠 Memoria persistente para tu agente de IA\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003ePersistent memory for your AI agent\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eTus notas en Markdown + git. El modelo las lee y escribe vía MCP. Todo local, todo tuyo.\u003c/em\u003e\u003cbr\u003e\n  \u003cem\u003eYour notes in Markdown + git. The model reads \u0026 writes them via MCP. All local, all yours.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/licencia-MIT-blue.svg\" alt=\"MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"./CHANGELOG.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/release-v3.11.0-orange.svg\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Vahlame/obsidian-memory-kit/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/Vahlame/obsidian-memory-kit/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003e📖 Léelo en · Read this in:\u003c/b\u003e\u0026nbsp;\n  \u003ca href=\"README.md\"\u003e🇪🇸 Español\u003c/a\u003e\u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"README.en.md\"\u003e🇬🇧 English\u003c/a\u003e\n  \u0026nbsp;|\u0026nbsp;\n  \u003cb\u003eDocs:\u003c/b\u003e\u0026nbsp;\n  \u003ca href=\"docs/es/README.md\"\u003e🇪🇸 Español\u003c/a\u003e\u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"docs/en/README.md\"\u003e🇬🇧 English\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## ¿Qué es esto? · What is this?\n\n🇪🇸 Un **kit multiplataforma** que le da a la IA (Cursor, Claude Code…) una **memoria que\nsobrevive entre chats**: una carpeta de notas Markdown bajo git que el agente lee y escribe a\ntravés de **MCP** (el puente entre el editor y tus archivos). Sin servicio en la nube. La pieza\nobligatoria es solo el servidor MCP; lo demás (búsqueda semántica, daemon de sync) es opcional.\n\n🇬🇧 A **cross-platform kit** that gives your AI (Cursor, Claude Code…) **memory that survives\nacross chats**: a folder of Markdown notes under git that the agent reads and writes through\n**MCP** (the bridge between the editor and your files). No cloud service. The only required piece\nis the MCP server; everything else (semantic search, sync daemon) is optional.\n\n\u003e ¿Cómo fluye la información? El diagrama de arriba lo resume; el detalle visual está en\n\u003e [**Cómo funciona**](docs/es/como-funciona.md) · [**How it works**](docs/en/how-it-works.md).\n\n---\n\n## Instalación rápida · Quick install\n\n**Un comando** conecta tu editor a un vault (lo crea si no existe, fusiona `mcp.json` sin romper\notras entradas, hace backup). Sin parámetros = asistente interactivo; con `-y` no pregunta nada:\n\n```bash\nnpx @vkmikc/create-obsidian-memory                 # asistente interactivo (pre-marca Codex + Claude)\nnpx @vkmikc/create-obsidian-memory -y              # sin preguntas → ~/Documents/obsidian-memory-vault\nnpx @vkmikc/create-obsidian-memory \"\u003cRUTA\u003e\" -y     # sin preguntas, en la ruta que elijas\n```\n\n\u003e ⚡ **Todo su potencial, en un solo comando · the whole stack in one command — `--full`.**\n\u003e Enfocado **primero en Codex y Claude Code**, con **todas las funciones activas por defecto ·\n\u003e every feature on by default**: registra el MCP en ambos, activa la búsqueda híbrida (BM25,\n\u003e semántica y grafo), el **grafo de conocimiento** (relaciones tipadas y observaciones), los\n\u003e **memory reports** y la **aceleración sqlite-vec**, instala el backend Python, construye el\n\u003e índice e instala las reglas — sin preguntas. Córrelo desde un clon del kit (o pásale\n\u003e `--repo-root \u003cclon\u003e`):\n\u003e\n\u003e ```bash\n\u003e npx @vkmikc/create-obsidian-memory --full          # = --ide codex,claude --with-hybrid --semantic --vec --build-index --install-backend --rules\n\u003e ```\n\u003e\n\u003e Si no hay clon a mano, `--full` **no aborta**: cae a `basic-memory` (sin híbrido) y avisa.\n\n¿Prefieres que **un agente lo instale**? Clónalo y dile _«instálalo»_: que ejecute `npm install` y\n`npm run setup` — preflight de dependencias → instalación `--full` → verificación → aviso de\nreinicio. · _Prefer an agent to do it?_ Clone it and have it run `npm install` then `npm run setup`.\n\n\u003e 🤖 **Claude Code / Codex (PC nuevo · fresh PC):** `--full` ya registra el MCP vía\n\u003e `claude mcp add` / `codex mcp add` y construye el índice en el mismo comando. Para Claude Code\n\u003e además deja el vault como **única** memoria: apaga la auto-memoria nativa (`autoMemoryEnabled:false`),\n\u003e instala un hook `SessionStart` del vault (ADR-0029), dos hooks de aplicación determinista —\n\u003e bloqueo de escritura a la memoria nativa + recordatorio de cierre — para que funcione con\n\u003e cualquier modelo (ADR-0030), y un hook de \"effort gate\" que pausa de verdad antes de\n\u003e ediciones sustanciales hasta que el usuario confirma (ADR-0031). ¿Solo lo básico? usa\n\u003e `--ide codex,claude`.\n\u003e Guía completa: [🇪🇸 instalar en PC nueva](docs/es/instalar-pc-nueva.md) ·\n\u003e [🇬🇧 fresh-PC install](docs/en/install-fresh-pc.md).\n\nLuego pega las **User Rules** y verifica. Los pasos completos (y la verificación) están en la guía:\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"50%\"\u003e\n\n🇪🇸 **[Guía de instalación →](docs/es/instalacion.md)**\n\no deja que [**un agente lo instale**](docs/es/instalar-con-agente.md)\n\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"50%\"\u003e\n\n🇬🇧 **[Install guide →](docs/en/install.md)**\n\nor let [**an agent install it**](docs/en/install-with-agent.md)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Qué incluye · What's inside\n\n| Pieza · Piece                                                          | Lenguaje | Rol                                                                                                            |\n| ---------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------- |\n| [`packages/create-obsidian-memory/`](packages/create-obsidian-memory/) | Node     | Instalador `npx` **(npm)**: fusiona el MCP y crea el vault.                                                    |\n| [`packages/obsidian-memory-mcp/`](packages/obsidian-memory-mcp/)       | Node     | MCP \"híbrido\" **(privado; corre desde el clon)**: tools del vault + búsqueda léxica/semántica.                 |\n| [`packages/obsidian-memory-rag/`](packages/obsidian-memory-rag/)       | Python   | Motor de búsqueda FTS5/BM25 + vectorial **(`pip install -e` desde el código)**; cero dependencias por defecto. |\n| [`cmd/obsidian-memoryd/`](cmd/obsidian-memoryd/)                       | Go       | Daemon opcional: vigila el vault y sincroniza git.                                                             |\n\nMapa técnico completo y diagramas de flujo: [`ARCHITECTURE.md`](ARCHITECTURE.md). El _porqué_ de\ncada decisión: [`docs/adr/`](docs/adr/).\n\n---\n\n## Más · More\n\n- **Seguridad / confianza:** [`SECURITY.md`](SECURITY.md) — el vault es **datos**, no instrucciones.\n- **PC nuevo · Fresh PC (Claude Code):** [🇪🇸 instalar en PC nueva](docs/es/instalar-pc-nueva.md) · [🇬🇧 fresh-PC install](docs/en/install-fresh-pc.md).\n- **Comparación con alternativas:** [FAQ 🇪🇸](docs/es/faq.md) · [FAQ 🇬🇧](docs/en/faq.md).\n- **Contribuir:** [`CONTRIBUTING.md`](CONTRIBUTING.md) · **Para agentes que tocan este repo:** [`AGENTS.md`](AGENTS.md).\n- **Privacidad / telemetría:** [`docs/observability.md`](docs/observability.md).\n\n## Licencia · License\n\nMIT — ver [`LICENSE`](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvahlame%2Fobsidian-memory-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvahlame%2Fobsidian-memory-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvahlame%2Fobsidian-memory-kit/lists"}