Gosidian

gosidian

Notas Markdown que tus agentes de IA pueden leer, escribir y razonar — vía MCP.

Un vault de markdown autocontenido con un servidor MCP integrado. Los humanos editan a través de una interfaz web, los agentes se comunican con él vía MCP, todo vive en archivos .md planos que Obsidian (y cualquier otra herramienta de markdown) lee de forma nativa.

Pruébalo en tu navegador

Lanza un gosidian gratuito y desechable en GitHub Codespaces — sin instalación, se ejecuta con tu propia cuota de Codespaces. Se compila desde el código fuente, inicializa un pequeño vault de demostración y abre la interfaz web. Inicia sesión con demo / gosidian-demo.

Inicio rápido

docker run -d --name gosidian \
  -p 8080:8080 \
  -v "$(pwd)/vault:/vault" \
  ghcr.io/daniele-chiappa/gosidian:latest
# open http://localhost:8080, create admin, copy the MCP token from /admin/tokens
claude mcp add gosidian http://localhost:8080/mcp \
  --transport http --header "Authorization: Bearer $TOKEN"

Tres comandos: Docker arriba → token creado desde la interfaz web → agente conectado. Tu vault de .md se persiste en ./vault/; detén el contenedor y los archivos siguen ahí.

Otras rutas de instalación (fuente, compose personalizado, bare-metal): docs/getting-started.md.

Qué es gosidian

• Un vault de markdown. Las notas son archivos .md en disco. Abre la misma carpeta en Obsidian, VS Code, vim o cualquier editor que ya uses. Cero bloqueo: elimina .gosidian/ y tienes un vault puro de Obsidian.
• Un servidor MCP. 57 herramientas tipadas permiten a los agentes iniciar una sesión, ingerir archivos, buscar, leer, escribir, enlazar, transferir, autoverificar y auditar. Autenticación con token Bearer y alcance por proyecto.
• Una interfaz web. Una aplicación de página única en Vue 3 servida desde el mismo binario (compilada con Vite, embebida vía go:embed). Notas, grafo, búsqueda y formularios de configuración se abren como ventanas en un espacio de trabajo "plancia" en mosaico — búsqueda de texto completo, backlinks, vista de grafo, editor con vista previa en vivo, registro de auditoría y páginas de administración para tokens y usuarios.

Las tres vistas acceden a los mismos archivos en disco. El índice SQLite FTS5 es una caché — elimínalo y se reconstruye.

Para quién es

• Ingenieros de IA que conectan agentes que necesitan memoria estructurada persistente: toma de notas, planes, habilidades, ADRs, transferencias, auditoría.
• Usuarios de Obsidian que quieren una capa programable sobre un vault en el que ya confían.
• Equipos con vault compartido + tokens con alcance por proyecto y por agente.

Por qué gosidian en lugar de X

• vs RAG / búsqueda vectorial: gosidian recupera por identidad (ruta, etiqueta, frontmatter, backlinks) — más predecible que la búsqueda por similitud para la memoria de trabajo de un agente. La búsqueda semántica se difiere deliberadamente: ver justificación ADR-007.
• vs Obsidian Sync: Sync replica un vault entre dispositivos humanos. gosidian añade una superficie de automatización tipada (MCP) al mismo vault. No compiten — se complementan.
• vs Notion / Roam: formatos alojados o propietarios; migrar es un proyecto. El vault de gosidian ya son archivos .md que puedes llevar a cualquier parte.

FAQ cubre la versión extensa.

Características destacadas

• Binario único, ≤50 MB, imagen Docker basada en Alpine
• Interfaz web: SPA en Vue 3 (Vite, Pinia, Tailwind, CodeMirror, Cytoscape), embebida en el binario — editor con vista previa en vivo, barra lateral, búsqueda, vista de grafo, adjuntos, registro de auditoría, páginas de administración
• Plancia gestor de ventanas en mosaico (estilo niri): notas, grafo, búsqueda y formularios de configuración se abren como ventanas redimensionables una al lado de otra en un espacio de trabajo con desplazamiento horizontal, restaurable desde la URL
• Servidor MCP sobre Streamable HTTP (HTTP+SSE heredado se mantiene) con 57 herramientas tipadas
• Tokens Bearer con alcances (read / write) y restricción por proyecto — incluidos tokens multiproyecto para orquestadores; revocación en cascada al deshabilitar un usuario
• Bus de orquestación de agentes: notas de transferencia con un ciclo de vida atómico de reclamación/completado, identidad sellada por el servidor y un feed de cambios por long-poll memory_wait_changes — una cola de tareas multiagente mínima donde todo sigue siendo markdown plano
• Inicio de sesión web multiusuario con control de acceso por roles (propietario / miembro / invitado), visibilidad pública/privada por proyecto y registro solo por invitación (TTL de 24 h)
• TOTP de dos factores opcional (modo global + anulación por usuario) e inicio de sesión LDAP / Active Directory con aprovisionamiento automático de invitados
• Sincronización git opcional (commits con debounce, push con autenticación por token)
• Búsqueda de texto completo SQLite FTS5 + bloqueo optimista con ETag
• Notas .html de primera clase, renderizadas en un iframe aislado (desactivado por defecto, opt-in por proyecto)
• Analítica de grafos sobre el grafo de wikilinks: memory_hubs (notas más enlazadas) y memory_path (ruta más corta entre dos notas)
• Bucle de auto-mejora opt-in: los agentes registran ideas de fricción de uso por token, desactivado por defecto
• Imprimir / Guardar como PDF para cualquier nota markdown directamente desde la interfaz web
• Internacionalización (IT + EN completas; ES / FR / DE en estructura)
• Presets de tema claro y oscuro (Catppuccin, Tokyo Night, Solarized) + paleta personalizada
• Diseño de proyecto Karpathy-Wiki-Stack con opiniones propias y scaffolding en una sola llamada
• Proyectos globales opcionales para habilidades, agentes y plantillas de scaffolding compartidas entre proyectos (opt-in por proyecto, local-sobre-global)

Documentación

Área	Empieza aquí
Instalar + configurar	Primeros pasos, Configuración, Despliegue
Integración MCP	Visión general, Catálogo de herramientas, Autenticación, Configuración de cliente, Patrones de agente
Interfaz web	Visión general, Editor, Autenticación y roles, Ajustes
Vault	Formato, Convenciones, Multiproyecto, Proyectos globales, Compatibilidad con Obsidian
Internals	Arquitectura, Desarrollo
Preguntas frecuentes	FAQ

Índice completo: docs/README.md.

Contribuciones

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md para el flujo de trabajo, las expectativas de pruebas y las pautas de traducción.

Seguridad

Los problemas de seguridad se reportan de forma privada. Consulta SECURITY.md para el proceso de divulgación.

Licencia

Publicado bajo la Licencia MIT.

Ver también

• PROJECT-STORY.md — génesis del proyecto, filosofía de diseño y una comparación con Obsidian / Logseq / stacks de conocimiento basados en RAG.
• CHANGELOG.md — historial de versiones.
• Filosofía de diseño y génesis del proyecto.