garden-md

Cos'è garden-md?

garden-md è uno strumento da riga di comando che trasforma le trascrizioni delle riunioni (e note correlate) in una knowledge base aziendale strutturata e collegata. Genera una wiki HTML in stile Wikipedia da file markdown salvati localmente, per navigare persone, aziende, prodotti/strumenti della tua organizzazione e le loro menzioni nei documenti.

Il suo scopo principale è aiutare i team a organizzare materiale transcript sparso in un formato navigabile, mantenendo le trascrizioni originali verbatim (non riscritte o riassunte). Puoi sincronizzare dati da servizi supportati, estrarre entità, collegare menzioni e aprire la wiki nel browser.

Caratteristiche Principali

• Sincronizza trascrizioni da più fonti (staging locale + wiki locale): Esegui garden sync per scaricare nuove trascrizioni da Grain, Granola, Fireflies.ai o un connettore “Other” basato su API in un'area di staging locale.
• Estrazione entità tra documenti: Durante garden tend, lo strumento estrae entità come persone, aziende e prodotti/strumenti e le usa per organizzare le pagine wiki.
• Pagine wiki collegate e navigabili in markdown: L'output consiste in file .md collegati che crescono nel tempo man mano che più documenti fanno riferimento a entità esistenti o nuove.
• Rendering HTML in stile Wikipedia: garden open genera e serve una wiki HTML con navigazione, ricerca e backlink.
• Operazione locale-first: La wiki è salvata come cartelle di file markdown sulla tua macchina, non in un database cloud.
• Integrazione git opzionale / commit automatici: garden init può abilitare git, e la wiki può essere aggiornata con commit automatici (opzionale per setup).
• Approccio connettori con review per servizi custom: I connettori integrati sono pre-costruiti e testati; per “Other”, l'AI genera uno script connettore da rivedere prima dell'esecuzione.
• Obiettivi non inclusi chiariti (preserva trascrizioni): Non riscrive o riassume contenuti; le trascrizioni rimangono verbatim nei documenti sorgente.

Come Usare garden-md

1. Installa e prerequisiti: Installa con npm install -g garden-md. Usa Node.js 18+ e fornisci una API key per un provider AI supportato.
2. Inizializza la tua wiki: Esegui garden init per scegliere il provider AI, configurare la posizione wiki e opzionalmente abilitare git.
3. Collega una sorgente dati: Esegui garden connect e seleziona un servizio—Grain, Granola, Fireflies.ai o Other—per configurare la sincronizzazione. Per “Other”, fornisci nome servizio e URL documentazione API.
4. Sincronizza nuove trascrizioni: Esegui garden sync per scaricare nuove trascrizioni nell'area di staging (mostrata come “wildland” nell'output demo).
5. Elabora nella wiki: Esegui garden tend per estrarre entità, creare pagine stub e generare una struttura markdown/wiki collegata; poi esegui garden open per navigare la wiki HTML generata.

Comandi comuni includono: garden connect --repair (per riparare connettori rotti), garden sync --schedule (sync automatico basato su cron) e garden tend / garden open per elaborare e navigare.

Casi d'Uso

• Trasforma trascrizioni riunioni in wiki interna ricercabile: Dopo la sincronizzazione da una sorgente note/trascrizioni riunioni, esegui garden tend per generare pagine entità e backlink, così i membri team possono navigare la conoscenza aziendale per persona, azienda o prodotto/strumento.
• Mantieni un “cervello aziendale” basato su materiale sorgente verbatim: Poiché garden-md evita riscritture/riassunti, i team possono fidarsi del contenuto transcript originale beneficiando di uno strato wiki strutturato.
• Aggiorna continuamente pagine wiki con nuove riunioni: Usa garden sync (opzionalmente con --schedule) per importare nuove trascrizioni, poi riesegui garden tend così la wiki cresce e i collegamenti si espandono con documenti aggiuntivi che referenziano entità.
• Onboarding team o stakeholder con layer navigazione comune: Usa garden open per navigare una wiki HTML con navigazione sidebar e ricerca, facilitando il ritrovamento menzioni rilevanti tra molte trascrizioni.
• Integra sorgente trascrizioni custom via API: Scegli “Other” in garden connect e fornisci documentazione API; lo strumento genera uno script connettore da rivedere prima dell'esecuzione.

FAQ

• garden-md riscrive o riassume le mie trascrizioni? No. garden-md mantiene le trascrizioni verbatim (non riscrive o riassume contenuti).

• Dove è salvata la wiki? Come file markdown locali (cartelle di file .md) sulla tua macchina; non richiede database o storage cloud.

• Quali servizi sono supportati out-of-the-box? Il repository elenca connettori integrati testati per Grain, Granola e Fireflies.ai. Per altri servizi, usa “Other” con documentazione API.

• Cosa fanno garden tend e garden open? garden tend legge dall'area staging, invia contenuti al tuo provider AI per estrazione entità e aggiorna la wiki markdown collegata. garden open rende e serve la wiki HTML per la navigazione.

• Quali prerequisiti sono richiesti? Il README specifica che è richiesto Node.js 18+, e serve una API key da un provider AI supportato.

Alternative

• Costruisci una wiki manualmente con markdown + script: Se hai bisogno solo di organizzazione base, puoi creare e collegare pagine markdown da solo senza estrazione entità AI-driven e workflow di rendering HTML.
• Usa una piattaforma di documentazione/wiki con pipeline di import: Le knowledge base generiche possono archiviare e cercare documenti, ma il workflow è diverso perché garden-md genera specificamente pagine entità cross-linkate in stile Wikipedia dalle trascrizioni.
• Strumenti di summarizzazione trascrizioni con knowledge base: Alcuni tool si concentrano sulla summarizzazione delle trascrizioni e indicizzazione dei riassunti; l'approccio di garden-md è diverso perché preserva il testo originale e costruisce link entità strutturati invece di sostituire il contenuto con riassunti.
• Pipeline ETL custom (sync → parse → index): Per team con supporto engineering, puoi replicare il pattern “sync + estrazione entità + linking” con i tuoi tool e storage, invece di usare il set di comandi e renderer wiki di garden-md.