garden-md

garden-mdとは？

garden-mdは、会議の文字起こし（および関連ノート）を構造化されたリンク付きの会社ナレッジベースに変換するコマンドラインツールです。ローカルに保存されたMarkdownファイルからWikipedia風のHTMLウィキを生成し、組織内の人物、会社、製品/ツール、およびそれらがドキュメント全体でどのように言及されているかを閲覧できます。

主な目的は、散在した文字起こし素材を閲覧可能な形式に整理しつつ、元の文字起こしをそのまま保持（書き換えや要約なし）することです。対応サービスからデータを同期し、エンティティを抽出、言及をリンクし、生成されたウィキをブラウザで開けます。

主な機能

• 複数ソースから文字起こしを同期（ローカルステージング + ローカルウィキ）: garden syncを実行して、Grain、Granola、Fireflies.ai、またはAPIベースの「Other」コネクタから新しい文字起こしをローカルステージングエリアに取得。
• ドキュメント全体でのエンティティ抽出: garden tend実行時に、人物、会社、製品/ツールなどのエンティティを抽出し、ウィキページを整理。
• Markdown形式のリンク付き閲覧可能ウィキページ: 出力はリンク付きの.mdファイルで構成され、ドキュメントが増えるにつれて既存/新規エンティティを参照して成長。
• Wikipedia風HTMLレンダリング: garden openでナビゲーション、検索、バックリンク付きのHTMLウィキを生成・提供。
• ローカル優先運用: ウィキはクラウドデータベースではなく、マシン上のMarkdownファイルのフォルダとして保存。
• オプションのgit統合 / 自動コミット: garden initでgitを有効化可能で、ウィキを自動コミットで更新（設定によりオプション）。
• カスタムサービス向けコネクタアプローチ + レビュー: ビルトインコネクタは事前構築・テスト済み。「Other」ではAIがコネクタスクリプトを生成し、実行前にレビュー表示。
• 非目標の明確化（文字起こしを保持）: コンテンツを書き換えたり要約したりしません。ソースドキュメント内の文字起こしはそのまま保持。

garden-mdの使い方

1. インストールと前提条件: npm install -g garden-mdでインストール。Node.js 18+を使用し、対応AIプロバイダのAPIキーを用意。
2. ウィキ初期化: garden initを実行してAIプロバイダを選択、ウィキ場所を設定、gitをオプションで有効化。
3. データソース接続: garden connectを実行し、Grain、Granola、Fireflies.ai、またはOtherを選択して同期を設定。「Other」の場合、サービス名とAPIドキュメントURLを指定。
4. 新規文字起こし同期: garden syncでステージングエリア（デモ出力では「wildland」と表示）に新しい文字起こしを取得。
5. ウィキへ処理: garden tendでエンティティ抽出、スタブページ作成、リンク付きMarkdown/ウィキ構造生成後、garden openで生成HTMLウィキを閲覧。

一般的なコマンド: garden connect --repair（壊れたコネクタ修正）、garden sync --schedule（cronベース自動同期）、garden tend / garden open（処理・閲覧）。

ユースケース

• 会議文字起こしを検索可能内部ウィキに変換: 会議ノート/文字起こしソースから同期後、garden tendを実行してエンティティページとバックリンクを生成。チームメンバーが人物、会社、製品/ツールで会社知識を閲覧。
• 原文素材ベースの「会社ブレイン」を保持: garden-mdは書き換え/要約を避けるため、構造化ウィキ層の利点を得つつ、元の文字起こし内容に依存可能。
• 新規会議到着時にウィキページを継続更新: garden sync（オプションで--schedule）で新規文字起こし取得後、garden tendを再実行してウィキ成長とリンク拡張。
• チーム/ステークホルダーのオンボーディングに共通ナビゲーション層: garden openでサイドバーナビゲーションと検索付きHTMLウィキを閲覧し、多数の文字起こし横断で関連言及を容易に発見。
• API経由カスタム文字起こしソース統合: garden connectで「Other」を選択しAPIドキュメント提供。ツールが実行前にレビュー可能なコネクタスクリプト生成。

FAQ

• garden-mdは文字起こしを書き換えたり要約したりしますか？ いいえ。garden-mdは文字起こしをそのまま保持（書き換えや要約なし）。

• ウィキはどこに保存されますか？ マシン上のローカルMarkdownファイル（.mdファイルのフォルダ）として。データベースやクラウドストレージ不要。

• 最初から対応サービスは？ リポジトリにGrain、Granola、Fireflies.aiのビルトインテスト済みコネクタ記載。他サービスはAPIドキュメント付き「Other」使用。

• garden tendとgarden openは何をしますか？ garden tendはステージングエリア読み込み、AIプロバイダへコンテンツ送信でエンティティ抽出、リンク付きMarkdownウィキ更新。garden openはHTMLウィキをレンダリング・提供して閲覧。

• 前提条件は何ですか？ READMEにNode.js 18+必須と記載。対応AIプロバイダのAPIキーが必要。

代替案

• Markdown + スクリプトで手動wiki構築： 基本的な整理だけで十分なら、AI駆動のエンティティ抽出やHTMLレンダリングなしで、自分でMarkdownページを作成・リンクできます。
• **インポートパイプライン付きドキュメント/wikiプラットフォーム：**汎用ナレッジベースはドキュメントの保存・検索が可能ですが、garden-mdはトランスクリプトからWikipedia風のクロスリンク付きエンティティページを生成するため、ワークフローが異なります。
• **トランスクリプト要約ツール + ナレッジベース：**一部のツールはトランスクリプトの要約とインデックスに特化していますが、garden-mdは原文を保持し、要約でコンテンツを置き換えるのではなく構造化エンティティリンクを構築します。
• **カスタムETLパイプライン（同期 → 解析 → インデックス）：**エンジニアリングサポートがあるチームなら、自前のツールとストレージで「同期 + エンティティ抽出 + リンク」パターンを再現可能で、garden-mdのコマンドセットやwikiレンダラを使いません。