ahmedkhaleel2004/gitdiagram

GitHub リポジトリをアーキテクチャ図と説明動画に自動変換するツール

完成アプリ自由に使える · MIT企画・設計TypeScript難易度
18,012+304今週👀 180 保存
1,386フォーク26Issue
デモ・公式サイトをひらくgitdiagram.com

中辛 の解説

GitHub リポジトリの構造を可視化して理解するツールです。Next.js・React・TypeScript・Mermaid・Claude/GPT を組み合わせ、リポジトリを分析してアーキテクチャ図、説明文、説明動画を生成します。Web 版はすぐに使え、ローカル実行も可能です。ローカル実行には Bun・Cloudflare R2・Upstash Redis・API キー(OpenAI/OpenRouter)が必要で、Vercel にデプロイされています。生成された図はクリックでコードへ遷移でき、PNG エクスポートや Mermaid ソースの取得もできます。

こんなリポジトリです

こんなときに便利です

  • 新規プロジェクト担当者がコードベースの構造と主要な依存関係を素早く把握する
  • 既存オープンソースプロジェクトのアーキテクチャを学習・分析する
  • AI エージェント(Claude など)がリポジトリ情報を自動取得して技術的な質問に回答する

主な機能

GitHub リポジトリを対話的なアーキテクチャ図に自動変換AI が生成する 1 分程度の説明動画(MP4 形式・字幕入り)MCP サーバー統合で Claude・Cursor・VS Code などから利用可能

ほかとの違い

説明動画の自動生成と MCP サーバー統合により、開発者の視覚的な学習と AI エージェントによる自動分析の両立を実現しています。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Bun(ローカル実行時)
  • Cloudflare R2 アカウント(ローカル実行時)
  • Upstash Redis(ローカル実行時)
  • OpenAI または OpenRouter API キー(ローカル実行時)
  • GitHub トークン(プライベートリポジトリ用・オプション)

すぐに始める

  1. リポジトリをクローンしてディレクトリに移動します
git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
cd gitdiagram
  1. Bun で依存関係をインストールします
bun install
  1. 環境設定ファイルをコピーします
cp .env.example .env
  1. .env を docs/dev-setup.md の設定ガイドに従って編集します(Cloudflare R2、Upstash Redis、OpenAI/OpenRouter API キー、GitHub トークンなど)

  2. 開発サーバーを起動します

bun run dev
  1. ブラウザで http://localhost:3000 を開きます

説明動画機能を有効にする場合、.env に VIDEO_EXPLAINER_ENABLED=1、NEXT_PUBLIC_VIDEO_EXPLAINER=1、ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY を設定してください。

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try ahmedkhaleel2004/gitdiagram

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

18,012+304 / 7日

確認日時

使いやすさ · まねしやすいか

サンプル評点 34/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2024 年に作成

「企画・設計」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/ahmedkhaleel2004/gitdiagram.svg)](https://www.gitbap.com/r/ahmedkhaleel2004/gitdiagram)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る