garden-md

Was ist garden-md?

garden-md ist ein Kommandozeilen-Tool, das Meeting-Transkripte (und zugehörige Notizen) in eine strukturierte, verlinkte Unternehmens-Wissensbasis umwandelt. Es erzeugt eine Wikipedia-ähnliche HTML-Wiki aus lokal gespeicherten Markdown-Dateien, sodass Sie Personen, Unternehmen, Produkte/Tools Ihrer Organisation und deren Erwähnungen über Dokumente hinweg durchsuchen können.

Sein Kernzweck ist es, Teams dabei zu helfen, verstreute Transkript-Materialien in ein durchsuchbares Format zu organisieren, während die Originaltranskripte wörtlich (nicht umgeschrieben oder zusammengefasst) erhalten bleiben. Sie können Daten aus unterstützten Diensten synchronisieren, Entitäten extrahieren, Erwähnungen verknüpfen und die resultierende Wiki in Ihrem Browser öffnen.

Wichtige Funktionen

• Transkripte aus mehreren Quellen synchronisieren (lokales Staging + lokale Wiki): Führen Sie garden sync aus, um neue Transkripte von Grain, Granola, Fireflies.ai oder einem API-basierten „Other“-Connector in einen lokalen Staging-Bereich zu ziehen.
• Entitätsextraktion über Dokumente hinweg: Während garden tend extrahiert das Tool Entitäten wie Personen, Unternehmen und Produkte/Tools und nutzt sie zur Organisation von Wiki-Seiten.
• Verlinkte, durchsuchbare Wiki-Seiten in Markdown: Die Ausgabe besteht aus verknüpften .md-Dateien, die mit der Zeit wachsen, wenn weitere Dokumente bestehende oder neue Entitäten referenzieren.
• Wikipedia-ähnliche HTML-Darstellung: garden open erzeugt und serviert eine HTML-Wiki mit Navigation, Suche und Backlinks.
• Local-first-Betrieb: Die Wiki wird als Ordner mit Markdown-Dateien auf Ihrem Rechner gespeichert, nicht in einer Cloud-Datenbank.
• Optionale Git-Integration / automatisierte Commits: garden init kann Git aktivieren, und die Wiki kann mit Commits automatisch aktualisiert werden (optional pro Setup).
• Connector-Ansatz mit Review für Custom-Services: Eingebauten Connectoren sind vorkonfiguriert und getestet; für „Other“ erzeugt die KI ein Connector-Skript zur Überprüfung vor der Ausführung.
• Klare Non-Goals (Transkripte bleiben unverändert): Es schreibt Inhalte nicht um oder fasst sie zusammen; Transkripte bleiben wörtlich in den Quell-Dokumenten.

So verwenden Sie garden-md

1. Installation und Voraussetzungen: Installieren Sie mit npm install -g garden-md. Verwenden Sie Node.js 18+ und stellen Sie einen API-Schlüssel für einen unterstützten AI-Provider bereit.
2. Wiki initialisieren: Führen Sie garden init aus, um Ihren AI-Provider zu wählen, den Wiki-Standort zu konfigurieren und optional Git zu aktivieren.
3. Datenquelle verbinden: Führen Sie garden connect aus und wählen Sie einen Dienst—Grain, Granola, Fireflies.ai oder Other—zur Konfiguration des Syncs. Für „Other“ geben Sie den Dienstenamen und die API-Dokumentations-URL an.
4. Neue Transkripte synchronisieren: Führen Sie garden sync aus, um neue Transkripte in den Staging-Bereich zu ziehen (angezeigt als „wildland“ in der Demo-Ausgabe).
5. In Wiki verarbeiten: Führen Sie garden tend aus, um Entitäten zu extrahieren, Stumpf-Seiten zu erstellen und eine verknüpfte Markdown-/Wiki-Struktur zu erzeugen; dann garden open, um die generierte HTML-Wiki zu durchsuchen.

Häufige Befehle: garden connect --repair (um defekte Connectoren zu reparieren), garden sync --schedule (cron-basierter automatischer Sync) und garden tend / garden open zum Verarbeiten und Durchsuchen.

Anwendungsfälle

• Meeting-Transkripte in durchsuchbare interne Wiki umwandeln: Nach dem Sync von Transkripten aus einer Meeting-Notiz-/Transkript-Quelle führen Sie garden tend aus, um Entitäten-Seiten und Backlinks zu erzeugen, damit Teammitglieder Unternehmenswissen nach Person, Unternehmen oder Produkt/Tool durchsuchen können.
• „Company Brain“ mit wörtlichen Quellmaterialien aufrechterhalten: Da garden-md Umformulierungen/Zusammenfassungen vermeidet, können Teams auf den Original-Transkript-Inhalt vertrauen und dennoch von einer strukturierten Wiki-Schicht profitieren.
• Wiki-Seiten kontinuierlich mit neuen Meetings aktualisieren: Nutzen Sie garden sync (optional mit --schedule), um neue Transkripte einzuziehen, dann garden tend erneut ausführen, damit die Wiki wächst und Verknüpfungen erweitert werden, wenn weitere Dokumente Entitäten referenzieren.
• Teams oder Stakeholder mit gemeinsamer Navigationsschicht onboarden: Nutzen Sie garden open, um eine HTML-Wiki mit Seitenleisten-Navigation und Suche zu durchsuchen, was das Finden relevanter Erwähnungen über viele Transkripte erleichtert.
• Custom-Transkript-Quelle via API integrieren: Wählen Sie „Other“ in garden connect und liefern Sie API-Dokumentation; das Tool erzeugt ein Connector-Skript zur Überprüfung vor der Ausführung.

FAQ

• Schreibt oder fasst garden-md meine Transkripte um? Nein. garden-md behält Transkripte wörtlich (es schreibt oder fasst Inhalte nicht um).

• Wo wird die Wiki gespeichert? Als lokale Markdown-Dateien (Ordner mit .md-Dateien) auf Ihrem Rechner; es wird keine Datenbank oder Cloud-Speicher benötigt.

• Welche Dienste sind out-of-the-box unterstützt? Das Repository listet getestete eingebaute Connectoren für Grain, Granola und Fireflies.ai. Für andere Dienste können Sie „Other“ mit API-Dokumentation nutzen.

• Was machen garden tend und garden open? garden tend liest aus dem Staging-Bereich, sendet Inhalte an Ihren AI-Provider zur Entitätsextraktion und aktualisiert die verknüpfte Markdown-Wiki. garden open rendert und serviert die HTML-Wiki zum Durchsuchen.

• Welche Voraussetzungen gibt es? Das README gibt an, dass Node.js 18+ erforderlich ist und Sie einen API-Schlüssel von einem unterstützten AI-Provider benötigen.

Alternativen

• Wiki manuell mit Markdown + Skripten erstellen: Wenn du nur grundlegende Organisation brauchst, kannst du Markdown-Seiten selbst erstellen und verlinken – ohne KI-gestützte Entity-Extraktion und HTML-Rendering-Workflows.
• Dokumentations-/Wiki-Plattform mit Import-Pipelines nutzen: Allgemeine Wissensdatenbanken speichern und durchsuchen Dokumente, aber der Workflow unterscheidet sich, da garden-md speziell Wikipedia-ähnliche, vernetzte Entity-Seiten aus Transkripten generiert.
• Transkript-Zusammenfassungs-Tools mit Wissensdatenbanken: Manche Tools fassen Transkripte zusammen und indizieren diese; garden-md’s Ansatz ist anders, da er den Originaltext erhält und strukturierte Entity-Links aufbaut, statt Inhalte durch Zusammenfassungen zu ersetzen.
• Eigene ETL-Pipelines (Sync → Parse → Index): Für Teams mit Engineering-Support kannst du das „Sync + Entity-Extraktion + Verlinkung“-Muster mit eigenen Tools und Speicher nachbauen, statt garden-md’s Befehlen und Wiki-Renderer zu nutzen.