OBSIDIAN · PLUGIN · TYPESCRIPT
Repo Notebook para Obsidian
Un plugin de Obsidian que pone tu estantería de Repo Notebook dentro de tu propio vault: cada repo de GitHub guardado se convierte en una nota, los repos relacionados pasan a ser wikilinks, y clonar, instalar y ejecutar quedan a un comando de distancia.
RESULTADO
Toda tu colección de GitHub como notas enlazadas en Obsidian, sincronizada en ambos sentidos con la app.
01 EL PROBLEMA
Repo Notebook guardaba mi colección de GitHub en su propia app, pero mis notas están en Obsidian. Dos sitios significan trabajo doble: lo que sabes de un repo debe estar junto al resto de tu conocimiento, con búsqueda y enlaces, sin que se desincronice.
02 QUÉ HACE
- Cada repo, una nota
- Una nota Markdown por repo con frontmatter (estrellas, lenguaje, temas, estado, clúster, salud), un resumen, la valoración de la IA, los archivos principales y el README. Además, una nota índice por clúster y estado.
- Repos relacionados como wikilinks
- Los enlaces del grafo de conocimiento de la app se convierten en verdaderos [[wikilinks]], con el motivo al lado. Así la vista de grafo de Obsidian muestra tu mapa completo de repos. Etiquetas como #repo/taal/python dan grupos de color.
- Sincronización en ambos sentidos
- Cambia tu estado, categoría o notas en Obsidian y algo más de un segundo después aparece en la app, y al revés. Tu bloque de Notas nunca se sobrescribe; un repo eliminado se marca, no se borra.
- Panel lateral con acciones
- Búsqueda, filtros de estado, una lista A–Z y un menú contextual con clonar, instalar, iniciar, detener, log y git pull. Si la app está apagada, leer, sincronizar y añadir repos siguen funcionando.
- Tabla de Bases
- Una tabla lista para usar en Obsidian Bases: todos los repos, ‘para probar’, ‘clonados’ y una vista por clúster.
- Instalar en 3 pasos
- Instala BRAT desde los plugins de la comunidad, elige ‘Add beta plugin’ y pega TMSHuybrechts/obsidian-repo-notebook. Después BRAT mantiene el plugin actualizado por sí solo.
03 LO QUE APRENDÍ
La pregunta más difícil no fue técnica sino: ¿qué es de quién? En cuanto quedó claro qué parte de una nota gestiona la app y cuál es tuya, la sincronización en ambos sentidos se volvió fiable. La lógica central funciona sin Obsidian y está probada contra una pequeña versión simulada de la API de Obsidian; una sincronización de 122 repos tarda unos 0,3 segundos.
¿TE INTERESA?
Vamos a hablar.
Dime qué te parece — o qué te gustaría hacer con ello.