GitDiagramとは?
GitDiagram は、Ahmed Khaleel 氏による Web アプリでありオープンソースの Next.js プロジェクトで、GitHub のリポジトリを対話型のアーキテクチャ図に変えます。AI モデルがリポジトリのファイルツリー、README、最大 12 のソースファイルを読んで短い概要を書き、ラベル付きの接続を持つ最大 34 のグループ化されたコンポーネントのグラフを返します。グラフを Mermaid にコンパイルする前に、リンクされたすべてのパスを実際のツリーと照合し、各コンポーネントから GitHub 上の該当ファイルやフォルダーを開けます。
図は保存されて共有されるため、誰かがすでに図にしたリポジトリはすぐに開きます。サイトでは約 1 分のナレーション付き解説動画も作れ、PNG や Mermaid のソースを書き出せ、保存されたすべての図の Markdown 版を gitdiagram.com/owner/repo.md で提供し、読み取り専用の無料のリモート MCP サーバーを gitdiagram.com/mcp で運営しています。プライベートリポジトリは読み取り専用の GitHub トークンで使えます。
リポジトリは 2024年12月に作成され、ライセンスは MIT で、GitHub のスターは約 18,700、フォークは 1,430 です。タグ付きのリリースは公開しておらず、最後のコミットは 2026年10月30日でした。
GitDiagramは使う価値があるか?
GitDiagram の価値は、手順がゼロのワークフローにあります。クローンもインストールも不要で、ほとんどの用途ではキーもいらず、最後に共有できるリンクが得られます。その裏のパイプラインは、URL の小技から想像するより慎重です。アーキテクチャのドキュメントによると、低い推論レベルの GPT-6 Luna へのリクエスト 1 回で、概要と厳密なグラフをストリーミングします。サーバーは識別子、接続性、リンクされたすべてのパスを実際のリポジトリと照合し、無効な出力はフィードバック付きで再試行させ、Mermaid を書くのはモデルではなく決定 論的なコンパイラーです。その後ブラウザーが SVG をサニタイズし、リンクは GitHub へのものだけを許可します。そのため、図そのものが正確でなくても、リンクは信頼できます。
上限は設計に組み込まれています。モデルが見るのはツリーの限られた抜粋、README、最大 12 のソースファイルで、描くコンポーネントは 34 個までです。小さなライブラリなら十分ですが、何十ものサービスを持つモノレポでは、パッケージ全体が 1 つの箱にまとまる大まかな図になります。プロジェクト自身のガイドも、これは重要な部分の地図であって完全な依存関係グラフではないとしています。GitHub が切り詰めたツリーとして返す非常に大きなリポジトリでも、部分的な一覧から図は作られますが、大きすぎる README はそのまま拒否されます。また、保存された図はリポジトリをその時点の状態で固定します。Regenerate で新しい図を作れます。
ホスト版サイトのデータの扱いは、プライバシーポリシーに平易に書かれています。リポジトリの内容は、依頼されたものを作るために OpenAI、Anthropic、OpenRouter に送られます。プライベートリポジトリには、Contents を読み取り専用にした fine-grained トークンか、選んだリポジトリに限定した Continue with GitHub のサインインが必要です。トークンは最長 30 日間 HttpOnly の Cookie に置かれ、サーバーには保存されません。プライベートな図は別の名前空間に保存されます。サイトでは PostHog のセッションリプレイが動いており、入力された文字はマスクされます。README と Markdown 版には有料のスポンサー枠があり、執筆時点では CodeRabbit です。
費用がかかるのは動画で、それに応じて量が制限されています。Claude Opus が台本を書き、Claude Haiku 5.5 が場面を設計し、OpenRouter 経由の Gemini 3.8 Flash TTS が読み上げ、whisper-1 が単語のタイミングを合わせます。デフォルトの上限は、UTC の 1 日あたりブラウザーごとに新しい動画 1 本、サイト全体で 25 本で、それを超えると 1 本 $3 です。チャット付きの複数ページの wiki を書く DeepWiki と比べると、GitDiagram はより狭い問いにより速く答えます。また、プライベートなコードやコミットしていないコードについては、手元のチェックアウトで動くコーディングエージェントの方が正確な図を描きます。
真価を発揮する場面
3 つのオープンソースのジョブキューライブラリを評価するバックエンドエンジニア
コードを読む前に、それぞれの構成を把握する
各 GitHub URL の「hub」を「diagram」に置き換えます。保存済みの図はすぐに開き、新しい図は約 1 分かかります。コンポーネントをクリックするとそのフォルダーに移動します。1 日の上限内なら無料で、超えた分は自分の OpenAI キーで支払います。
見慣れない依存関係に関わるタスクで Claude Code や Codex を使う開発者
ソースを貼り付けずに、依存関係の構造をエージェントに伝える
コマンド 1 つでリモート MCP サーバーを追加し、プロジェクトの構成をエージェントに尋ねます。エージェントは保存された概要、コンポーネント、接続、Mermaid のソースを読みます。無料で、デフォルトではネットワークごとに 1 時間あたり 120 回のツール呼び出しに制限され、公開リポジトリのみが対象です。
20 人規模のオープンソース企業の DevRel リーダー
プロジェクトの README にアーキテクチャ図と短い解説を載せる
図を PNG で書き出すか、Mermaid のソースを編集用の下書きとしてコピーし、解説動画を字幕焼き込みの横長または 9:16 の MP4 でダウンロードします。無料の 1 日の枠を超えた動画は $3 です。
導入前に確認すること
- 導入
- ホスト版では、URL を書き換えるか、ホームページに owner/repo を貼り付けます。新しい図には約 1 分かかります。セルフホストでは Bun 1.3.14 と Node 22 を用意して bun install を実行し、.env に Cloudflare R2 のバケット、Upstash Redis、CACHE_KEY_SECRET、OpenAI または OpenRouter のキーを設定してから bun run dev を実行します。
- 連携
- Claude、Claude Code、Codex、Cursor、VS Code、Gemini CLI、GitHub Copilot CLI、ChatGPT 向けのリモート MCP サーバー(get_repository_diagram、find_repository_diagrams、get_explainer_video)、/gitdiagram スキル付きの Claude Code プラグイン、/owner/repo.md の Markdown、PNG と Mermaid の書き出し。
- データとプライバシー
- 公開リポジトリの図と動画は、そのリポジトリを開く誰にでも公開されます。リポジトリの内容は OpenAI、Anthropic、OpenRouter に送られます。GitHub トークンと OpenAI キーは最長 30 日間ブラウザーの HttpOnly Cookie に置かれ、サーバーには保存されません。推奨されるトークンは Contents を読み取り専用にした fine-grained トークンです。サイトでは PostHog のアナリティクスとセッションリプレイが動いています。MIT ライセンスです。
- 大規模利用時のコスト
- ホスト版サイトにサブスクリプションはありません。セルフホストでは R2、Upstash、図ごとのモデルのトークンに支払います。プロジェクトは図 1 枚あたりのコストを公開していませんが、アプリは実行前に見積もりを表示し、オプションの Fast レーンではモデルの料金が 2 倍になります。動画では Anthropic、OpenAI、OpenRouter の呼び出しとヘッドレス Chromium でのレンダリングが加わります。
- 制限
- コードのデフォルトでは、サーバー負担の生成は IP ごとに 1 時間 8 回まで(自分のキーを使う場合は対象外)、生成エンドポイントへの呼び出しは 全員に 1 時間 60 回までです。生成の時間枠は 300 秒です。新しい動画の作成はアーリーアクセスで、1 日の上限があります。未解決の issue とプルリクエストは約 55 件で、タグ付きのリリースはありません。
良い点
- URL を書き換えるだけで動き、クローンもインストールも不要
- リンクされたすべてのパスを実際のリポジトリと照合
- 決定論的な Mermaid コンパイラーと GitHub 限定のリンク許可リスト
- エージェント向けの無料の読み取り専用 MCP サーバーと Markdown 版
気になる点
- ソースファイルは最大 12、コンポーネントは最大 34 で、モノレポでは大まか
- 保存された図は誰かが再生成するまで古いまま
- セルフホストには Cloudflare R2、Upstash Redis、モデルのキーが必要
- README と Markdown の出力にスポンサー枠がある
おすすめの人
コードを開く前に、見慣れない GitHub リポジトリの全体像をつかみたいエンジニアや、公開リポジトリの構造の要約がすぐに必要なエージェント。
GitDiagramの代替
GitDiagram:よくある質問
- GitDiagramは使う価値があるか?
- GitDiagram は、URL を書き換える程度の時間で、見慣れないリポジトリのまずまずの最初の地図を示してくれます。ただし設計図ではなく下書きとして扱うことが前提です。 評価は5点満点中4.0点です。
- GitDiagramの料金は?
- 無料で使えるオープンソース(MIT)です。新しい図は 1 日の上限内なら無料で、それを超えると自分の OpenAI API キーが必要です。無料の 1 日の枠を超えた解説動画は 1 本 $3 です。
- GitDiagramの欠点は?
- ソースファイルは最大 12、コンポーネントは最大 34 で、モノレポでは大まか; 保存された図は誰かが再生成するまで古いまま; セルフホストには Cloudflare R2、Upstash Redis、モデルのキーが必要; README と Markdown の出力にスポンサー枠がある.
- GitDiagramは誰に向いているか?
- コードを開く前に、見慣れない GitHub リポジトリの全体像をつかみたいエンジニアや、公開リポジトリの構造の要約がすぐに必要なエージェント。
- チームや本番環境でGitDiagramを使うと費用はいくらか?
- ホスト版サイトにサブスクリプションはありません。セルフホストでは R2、Upstash、図ごとのモデルのトークンに支払います。プロジェクトは図 1 枚あたりのコストを公開していませんが、アプリは実行前に見積もりを表示し、オプションの Fast レーンではモデルの料金が 2 倍になります。動画では Anthropic、OpenAI、OpenRouter の呼び出しとヘッドレス Chromium でのレンダリングが加わります。
- GitDiagramは企業データを扱っても安全か?
- 公開リポジトリの図と動画は、そのリポジトリを開く誰にでも公開されます。リポジトリの内容は OpenAI、Anthropic、OpenRouter に送られます。GitHub トークンと OpenAI キーは最長 30 日間ブラウザーの HttpOnly Cookie に置かれ、サーバーには保存されません。推奨されるトークンは Contents を読み取り専用にした fine-grained トークンです。サイトでは PostHog のアナリティクスとセッションリプレイが動いています。MIT ライセンスです。
- GitDiagramの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はOpenWiki, Archify 、 Repomixです。
回答確認日:2026年10月31日
