garden-md

¿Qué es garden-md?

garden-md es una herramienta de línea de comandos que convierte transcripciones de reuniones (y notas relacionadas) en una base de conocimientos estructurada y enlazada para la empresa. Genera un wiki HTML al estilo Wikipedia a partir de archivos markdown almacenados localmente, para que puedas explorar las personas, empresas, productos/herramientas de tu organización y cómo se mencionan en los documentos.

Su propósito principal es ayudar a los equipos a organizar material de transcripciones disperso en un formato navegable, manteniendo las transcripciones originales textuales (sin reescribir ni resumir). Puedes sincronizar datos de servicios compatibles, extraer entidades, enlazar menciones y abrir el wiki resultante en tu navegador.

Características principales

• Sincroniza transcripciones de múltiples fuentes (staging local + wiki local): Ejecuta garden sync para obtener nuevas transcripciones de Grain, Granola, Fireflies.ai o un conector “Other” basado en API en un área de staging local.
• Extracción de entidades en documentos: Durante garden tend, la herramienta extrae entidades como personas, empresas y productos/herramientas y las usa para organizar páginas del wiki.
• Páginas de wiki enlazadas y navegables en markdown: La salida consta de archivos .md enlazados que crecen con el tiempo a medida que más documentos referencian entidades existentes o nuevas.
• Renderizado HTML al estilo Wikipedia: garden open genera y sirve un wiki HTML con navegación, búsqueda y backlinks.
• Operación local-first: El wiki se almacena como carpetas de archivos markdown en tu máquina, no en una base de datos en la nube.
• Integración opcional con git / commits automáticos: garden init puede habilitar git, y el wiki se puede actualizar con commits automáticos (opcional por configuración).
• Enfoque de conectores con revisión para servicios personalizados: Los conectores integrados están pre-construidos y probados; para “Other”, la IA genera un script de conector que se muestra para revisión antes de ejecutarlo.
• No objetivos aclarados (preserva transcripciones): No reescribe ni resume contenido; las transcripciones permanecen textuales en los documentos fuente.

Cómo usar garden-md

1. Instalación y requisitos previos: Instala con npm install -g garden-md. Usa Node.js 18+ y proporciona una API key de un proveedor de IA compatible.
2. Inicializa tu wiki: Ejecuta garden init para elegir tu proveedor de IA, configurar la ubicación del wiki y habilitar git opcionalmente.
3. Conecta una fuente de datos: Ejecuta garden connect y selecciona un servicio—Grain, Granola, Fireflies.ai o Other—para configurar la sincronización. Para “Other”, proporciona el nombre del servicio y la URL de la documentación de la API.
4. Sincroniza nuevas transcripciones: Ejecuta garden sync para obtener nuevas transcripciones en el área de staging (mostrada como “wildland” en la salida de demo).
5. Procesa en el wiki: Ejecuta garden tend para extraer entidades, crear páginas stub y generar una estructura markdown/wiki enlazada; luego ejecuta garden open para navegar el wiki HTML generado.

Comandos comunes incluyen: garden connect --repair (para arreglar conectores rotos), garden sync --schedule (sincronización automática basada en cron) y garden tend / garden open para procesar y navegar.

Casos de uso

• Convierte transcripciones de reuniones en un wiki interno buscable: Tras sincronizar transcripciones de una fuente de notas/reuniones, ejecuta garden tend para generar páginas de entidades y backlinks, para que los miembros del equipo exploren el conocimiento de la empresa por persona, empresa o producto/herramienta.
• Mantén un “cerebro de empresa” respaldado por material fuente textual: Como garden-md evita reescribir/resumir, los equipos pueden confiar en el contenido original de las transcripciones mientras aprovechan una capa de wiki estructurada.
• Actualiza páginas del wiki continuamente con nuevas reuniones: Usa garden sync (opcionalmente con --schedule) para incorporar nuevas transcripciones, luego vuelve a ejecutar garden tend para que el wiki crezca y los enlaces se expandan con documentos adicionales que referencien entidades.
• Onboardea equipos o stakeholders con una capa de navegación común: Usa garden open para navegar un wiki HTML con navegación lateral y búsqueda, facilitando encontrar menciones relevantes en muchas transcripciones.
• Integra una fuente de transcripciones personalizada vía API: Elige “Other” en garden connect y suministra documentación de API; la herramienta genera un script de conector para revisión antes de ejecutarlo.

Preguntas frecuentes

• ¿garden-md reescribe o resume mis transcripciones? No. garden-md mantiene las transcripciones textuales (no reescribe ni resume contenido).

• ¿Dónde se almacena el wiki? Como archivos markdown locales (carpetas de archivos .md) en tu máquina; no requiere base de datos ni almacenamiento en la nube.

• ¿Qué servicios están soportados de fábrica? El repositorio lista conectores integrados y probados para Grain, Granola y Fireflies.ai. Para otros servicios, puedes usar “Other” con documentación de API.

• ¿Qué hacen garden tend y garden open? garden tend lee del área de staging, envía contenido a tu proveedor de IA para extracción de entidades y actualiza el wiki markdown enlazado. garden open renderiza y sirve el wiki HTML para navegar.

• ¿Qué requisitos previos son necesarios? El README indica que se requiere Node.js 18+, y necesitas una API key de cualquier proveedor de IA compatible.

Alternativas

• Construir un wiki manualmente con markdown + scripts: Si solo necesitas organización básica, puedes crear y enlazar páginas markdown tú mismo sin extracción de entidades impulsada por IA ni flujos de renderizado HTML.
• Usar una plataforma de documentación/wiki con tuberías de importación: Las bases de conocimiento de propósito general pueden almacenar y buscar documentos, pero el flujo de trabajo es diferente porque garden-md genera específicamente páginas de entidades con enlaces cruzados al estilo Wikipedia a partir de transcripciones.
• Herramientas de resumen de transcripciones con bases de conocimiento: Algunas herramientas se centran en resumir transcripciones e indexar esos resúmenes; el enfoque de garden-md es diferente porque preserva el texto original y construye enlaces de entidades estructurados en lugar de reemplazar el contenido con resúmenes.
• Tuberías ETL personalizadas (sincronización → análisis → indexación): Para equipos que ya cuentan con soporte de ingeniería, puedes replicar el patrón “sincronización + extracción de entidades + enlazado” con tus propias herramientas y almacenamiento, en lugar de usar el conjunto de comandos y el renderizador de wiki de garden-md.