FolderTether: Obsidian escapa del vault

Un colega y yo estábamos hablando sobre los archivos Markdown y cómo se han convertido en el formato predeterminado para trabajar en entornos de IA. Naturalmente, la conversación derivó hacia Obsidian porque soy un gran fan. Mencionó algo que me quedó dando vueltas: no podía sentirse cómodo con el concepto de vault —la forma que tiene Obsidian de contener todo en una única carpeta gestionada— y eso le impedía usar la herramienta del todo. Había trasteado con este gran sistema de notas, pero su trabajo real no vivía en él. Su código estaba en otro sitio. Sus documentos estaban en otro sitio. Sus notas de Obsidian estaban en otro sitio. Tres lugares separados, sin ninguna conexión entre ellos.

Este es un problema con el que casi todos los usuarios de Obsidian se topan, y la mayoría simplemente lo acepta. Yo me había acostumbrado tanto a trabajar en el entorno de Obsidian que me había vuelto ciego a esta desconexión. Ahora que volvía a ser visible, no quería aceptarlo.

El problema real

Aquí va el escenario: tienes un proyecto llamado Alpha. El código vive en ~/Projects/Alpha. Los documentos del cliente viven en ~/Dropbox/Clients/Alpha. Las notas viven en Obsidian. Creas una nota de proyecto y pegas la ruta del directorio como recordatorio. Tres meses después, has reorganizado la carpeta. La ruta es incorrecta. Renombras la nota. Nada más se actualiza. Buscas "Alpha" en tres aplicaciones y encuentras la mitad de lo que necesitas.

Puede que estés pensando: ¿para qué usar Obsidian? Resulta que Obsidian es una aplicación excelente por varias razones, y la más relevante para esta audiencia es que funciona a la perfección con la IA.

Las herramientas empresariales como Confluence, Jira y SharePoint resuelven esto con funciones de "enlace a recurso externo". Pero para los usuarios individuales de Obsidian que trabajan en local, el límite del vault es rígido. Obsidian conoce todo lo que está dentro del vault y nada de lo que está fuera.

FolderTether es mi intento de resolver esto sin romper lo que hace bueno a Obsidian.

Qué hace FolderTether

El plugin crea un tether (amarre): un enlace bidireccional y persistente entre una nota de Obsidian y un directorio en cualquier parte de tu sistema de archivos. No es una sincronización, no es una copia, no es un espejo. Solo una conexión que funciona desde ambos extremos.

Desde Obsidian hacia afuera (el plugin):

Abre la paleta de comandos y ejecuta "FolderTether: Link note to directory." Se abre un selector de carpetas nativo de macOS. Seleccionas el directorio. Dos cosas ocurren:

1. El plugin escribe linked_dir en el frontmatter de la nota como un URI file:// en el que se puede hacer clic — se renderiza como un enlace clicable en el panel de Propiedades de Obsidian. Haz clic y el Finder abre ese directorio.
2. El plugin escribe un archivo [Nombre de nota].url en el directorio — un archivo estándar de acceso directo a Internet que contiene un URI obsidian://. Haz doble clic desde el Finder y abre la nota directamente.

Desde el Finder hacia adentro (la Quick Action):

Clic derecho en cualquier carpeta del Finder → "FolderTether" en el menú de Quick Actions. Introduce un nombre para la nota cuando se te pida. Las mismas dos cosas ocurren a la inversa: se escribe un archivo .url en la carpeta, y Obsidian se abre con una nueva nota ya creada y linked_dir pre-rellenado.

Ambos caminos producen el mismo resultado: una nota y una carpeta que se conocen mutuamente.

El archivo .url es la clave

"¿Espera, puedo navegar a mi nota de Obsidian desde el Finder?" Sí — desde cualquier ventana del Finder, cualquier sesión de Terminal, cualquier app que pueda abrir archivos. La nota ya no está encerrada dentro del vault. Tiene presencia en tu sistema de archivos real a través del archivo .url. Esto no requiere ninguna instalación en el lado del directorio, ningún software especial, ningún servicio en segundo plano. Haz doble clic en el Finder y abre un enlace obsidian:// que te lleva directamente a la nota.

La filosofía detrás

El principio central de diseño de Obsidian es que las conexiones importan más que la ubicación. Tus notas no necesitan vivir en una jerarquía de carpetas que refleje la realidad. La ubicación física es secundaria. Este enfoque es liberador pero requiere cierto reaprendizaje tras años de usar carpetas en tu disco local.

FolderTether extiende aún más este principio de las conexiones. La nota no necesita estar en una subcarpeta del vault que refleje tus directorios de proyecto. Puede vivir en la raíz del vault o donde tenga sentido conceptualmente. El tether es la relación — no la carpeta en la que está almacenada.

Esto es cada vez más relevante para los agentes de IA. Cuando Claude Code consulta tu vault, puede descubrir notas sobre tus proyectos y seguir el enlace linked_dir para encontrar el directorio del proyecto real — sin que tengas que decirle dónde están las cosas. El vault se convierte en un índice sobre todo tu espacio de trabajo digital, no solo sobre los archivos Markdown que contiene.

Estado actual

El plugin está disponible en GitHub: https://github.com/pablooliva/foldertether

Está en desarrollo activo. El flujo de trabajo principal — vincular una nota a un directorio y crear una nota desde el Finder — es funcional. Si encuentras algún problema o tienes peticiones de funcionalidades, abre un issue.

FolderTether es una pieza de un sistema más amplio para gestionar el conocimiento a través de herramientas, vaults y archivos locales. Los próximos artículos de esta serie cubrirán cómo encaja todo.