claude-obsidian
Sistema local-first de gestión de conocimiento para Obsidian y Claude Code que transforma fuentes en una base de conocimientos conectada mediante un bucle repetible: capturar con contexto, fundamentar afirmaciones, conectar aprendizajes y reutilizar el vault sin perder propiedad de los archivos.
Ficha actualizada 9 nov 2026, 20:38 · upstream 25 oct 2026, 22:24 · release v3.0.1
Qué es claude-obsidian
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
claude-obsidian es un sistema de gestión de conocimiento local-first diseñado para Claude Code y hosts compatibles con Agent Skills. Convierte material fuente en páginas vinculadas con citas a fuentes, proporciona respuestas fundamentadas en la evidencia existente del vault y ofrece flujos de trabajo explícitos para investigación, recuperación, mantenimiento y mapeo visual.
El sistema se organiza alrededor de un bucle repetible: retener el origen, fundamentar las afirmaciones, conectar el conocimiento y volver a ponerlo en uso. El vault permanece como un directorio normal de archivos Markdown, JSON y fuentes; no está oculto en una caché de plugin, bloqueado en una base de datos en la nube ni subido silenciosamente a un modelo.
La arquitectura prioriza la confianza mediante transacciones recuperables: cada operación lógica es una transacción recuperable que registra checksums SHA-256, fusiona cambios en un paquete único y aplica operaciones atómicas con restauración del estado anterior si falla. El sistema declara honestamente sus capacidades, detecta herramientas opcionales y degrada claramente cuando faltan adaptadores.
- Ingestión de fuentes locales con preservación de contexto inmutable antes de la síntesis
- Creación de respuestas fundamentadas en evidencia del vault con citas a fuentes duraderas
- Mantenimiento proactivo mediante linting para detectar enlaces rotos, huérfanos y metadatos faltantes
- Visualización de mapas de conocimiento en Obsidian Graph y Canvas con estructuras metodológicas
- Investigación web acotada con egress explícito y fusión canónica separada
- Organización flexible mediante modos de archivo (Generic, LYT, PARA, Zettelkasten) sin reorganizar datos existentes
- Arquitectura transaccional atómica que previene sobrescrituras silenciosas mediante verificación de checksums SHA-256
- Respeto a la propiedad de los archivos Markdown nativos sin caché oculto ni subida automática a servicios en la nube
- Transparencia en capacidades con degradación explícita cuando faltan adaptadores o herramientas opcionales
- Sistema de ledgers para fuentes y afirmaciones que retiene autoridad, frescura, soporte y estado de revisión
- Compatibilidad con múltiples hosts de agentes (Claude Code, Codex, OpenCode, Gemini, ZCode) mediante enlaces portables
- Mecanismos de recuperación de operaciones interrumpidas con restauración del estado anterior garantizada
- Soporte limitado para extracción semántica de PDF y EPUB sin runners externos configurados explícitamente
- Dependencia de consentimiento explícito para egress de red en URL, YouTube y OCR mediante runners externos
- Ausencia de sincronización automática con servicios en la nube; el vault es local-first por diseño
- Requiere revisión manual del plan JSON antes de aplicar operaciones mutantes (--apply)
- No incluye Docker ni contenerización nativa; despliegue directo en sistema operativo o WSL
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Pendiente de la cola editorial R11-R6 con investigación verificable.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.