Combinando Obsidian y Claude Code para acumular conocimiento sin desorden de archivos

Cualquiera que haya intentado mantener una base de conocimiento personal se ha encontrado con el mismo problema. Todo comienza con buenas intenciones: configurar un Obsidian bellamente estructurado, organizar los pensamientos de forma ordenada, vincular notas entre sí. Y un par de meses después, la bóveda se convierte en un caos de fragmentos de código copiados, enlaces sin procesar y borradores abandonados a medio terminar.

El investigador Andrej Karpathy alguna vez describió el concepto de una Wiki LLM: una idea donde una red neuronal ayuda a estructurar el conocimiento personal, transformándolo en un grafo coherente. El repositorio claude-obsidian lleva esta idea a la práctica. Es una herramienta local para Claude Code y hosts compatibles con Agent Skills que procesa los materiales entrantes por sí misma, verifica los hechos contra las fuentes primarias y organiza todo en archivos Markdown en tu disco.

¿Por qué molestarse cuando existen plugins de IA convencionales?

La mayoría de las extensiones de toma de notas con IA funcionan de manera simple: toman tu texto, lo envían a una base de datos en la nube, construyen un índice vectorizado y generan otro fragmento de texto generativo. Si cierras el plugin o cancelas tu suscripción, toda esta estructura "inteligente" desaparece.

En claude-obsidian, el enfoque es diferente. La base de conocimiento permanece como una carpeta regular con archivos Markdown, JSON y código fuente. Los datos no se ocultan en la caché interna del plugin ni se envían a servidores de terceros sin tu consentimiento. Toda la magia ocurre sobre tus propios archivos.

El sistema está construido alrededor de un proceso cíclico:

1. Depositas material en la carpeta inbox/. La herramienta crea una copia exacta e inmutable con un hash fijo.
2. Durante el análisis, la IA extrae declaraciones específicas del texto. Si los hechos son cuestionables o se contradicen entre sí, se marcan por separado. El sistema no inventa fuentes—referencia explícitamente el original guardado.
3. A partir del material procesado, se generan notas atómicas, índices y diagramas visuales en Obsidian Canvas.
4. La base terminada puede consultarse a través de Claude Code, pueden encontrarse contradicciones, buscarse enlaces rotos y agregarse nuevos temas.

El resultado parece una base de conocimiento bellamente organizada que es igualmente conveniente para trabajar tanto a través de un agente de IA como manualmente a través de la interfaz estándar de Obsidian.

Qué hay bajo el capó: 15 habilidades en una CLI

Los desarrolladores organizaron la funcionalidad como un conjunto de 15 habilidades llamadas "skills". Pueden invocarse como comandos separados desde Claude Code o usarse como scripts independientes.

Todas las habilidades se dividen en tres grupos lógicos:

• Operaciones de base de datos y wiki — inicialización de la bóveda (wiki), guardar respuestas exactas sin registrar desorden innecesario (save), analizar archivos de entrada (wiki-ingest), responder solo basándose en hechos verificados de la base de datos (wiki-query), y encontrar problemas como páginas huérfanas o secciones vacías (wiki-lint).
• Escenarios avanzados — búsqueda web autónoma con guardado aislado de resultados (autoresearch), generar tableros Obsidian Canvas (canvas), limpiar páginas web de desorden antes de leerlas (defuddle), agregación de logs (wiki-fold), y búsqueda contextual BM25 con re-ranking opcional (wiki-retrieve).
• Formateo y metodología — soporte para metodologías de toma de notas (wiki-mode), plantillas de marcado correctas en Obsidian Flavored Markdown (obsidian-markdown), y tablas nativas con bases de datos (obsidian-bases).

Un detalle interesante: el comando wiki-mode puede organizar nuevas notas en sistemas populares como PARA, Zettelkasten o LYT (Linking Your Thinking). Al mismo tiempo, los archivos antiguos se dejan intactos y nadie intenta renombrarlos por la fuerza.

Protección contra manos torpes y agentes paralelos

Si le das a un modelo de lenguaje acceso directo al sistema de archivos, tarde o temprano corromperá algo o eliminará una nota necesaria. El autor de claude-obsidian tuvo en cuenta este riesgo y diseñó un límite de confianza estricto.

Cualquier operación de modificación consiste en pasos seguros. Primero, el sistema toma hashes SHA-256 de todos los archivos afectados. Los procesos paralelos generan solo borradores de cambios. Luego el orquestador ensambla esto en un único paquete, te muestra el plan JSON final y espera confirmación.

Solo después de que verifiques el hash del plan aprobado y lo passes al comando --apply, los cambios se escribirán en disco. Si un archivo ha sido modificado durante la preparación, la escritura se cancelará. Si el proceso se interrumpe a mitad de camino, la operación revertirá desde la copia de seguridad.

Inicio rápido y uso diario

Se requiere Python versión 3.11 o superior para ejecutarlo. Si estás en Windows, necesitarás escribir cambios a través de WSL, ya que la versión nativa de Windows actualmente solo funciona en modos de solo lectura y simulación.

Clona el repositorio del proyecto en tu máquina:

git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian

Crea una carpeta separada para tu base de datos de notas y solicita un plan de inicialización:

export GENERATED_AT="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
export OPERATION_ID="init-reviewed"

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"

En la respuesta, verás un JSON detallado y la línea approved_plan_sha256. Copia el hash y confirma la ejecución:

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID" \
  --approved-plan-sha256 "<полученный-хэш>" --apply

Si ya tienes una bóveda de Obsidian funcionando, no necesitarás reescribirla desde cero. Para esto, se proporciona el comando adopt, que agrega cuidadosamente los archivos de índice y tablas necesarios sin tocar tu contenido personal.

A continuación, abre la carpeta creada en Obsidian y desde la consola lanza Claude Code:

cd "$HOME/Documents/MyKnowledgeVault"
claude --plugin-dir /абсолютный/путь/к/claude-obsidian

Comandos rápidos se vuelven disponibles dentro de Claude Code:

/claude-obsidian:wiki
/claude-obsidian:wiki-ingest
/claude-obsidian:wiki-lint

Deposita cualquier archivo de texto o artículo en inbox/ e invoca /claude-obsidian:wiki-ingest. La herramienta analizará el texto, creará las tarjetas necesarias, las enlazará con referencias cruzadas y actualizará el mapa de conocimiento general.

Para quién es perfecto este proyecto

claude-obsidian difícilmente es necesario para quienes usan Obsidian una vez a la semana para una lista de compras. Pero el proyecto será un hallazgo para quienes:

• Leen mucha documentación técnica, artículos y especificaciones que desean guardar en un formato conveniente.
• Conducen investigación de arquitectura y quieren ver conexiones entre diferentes tecnologías sin crear manualmente cientos de notas.
• No están listos para entregar sus notas personales a nubes cerradas o atarse a formatos propietarios.

El sistema gana con su honestidad: transacciones transparentes, salida limpia en Markdown, y ningún intento de hacer del modelo un "oráculo omnisciente". Si la red neuronal no está segura de un hecho o no puede encontrar confirmación en los archivos guardados, simplemente te lo dirá directamente.