ahmedkhaleel2004 /gitdiagram
Visualize any GitHub codebase: free interactive architecture diagrams and one-minute explainer videos. Replace 'hub' with 'diagram' in any GitHub URL.
★ 18,939⑂ 1,446👁 56⑃ 114● 123▤ 0
+12
Daily
18,939
stars
1,446
forks
56
watchers
114
prs
123
issues
0
releases
README
GitDiagram Visualize any codebase: turn any public or private GitHub repository into an interactive architecture diagram, or watch it explained in a one-minute narrated video. AI agents can use it too, through the MCP server or the Markdown version of any diagram (gitdiagram.com/owner/repo.md). Try GitDiagram → · Or replace hub with diagram in any GitHub repository URL. Sponsored AI code reviews for your pull requests. Try CodeRabbit → New: explainer videos GitDiagram can now turn a repository into a narrated video of about a minute. The video starts with what the project is for and what people do with it, then shows briefly how its main parts fit together and one decision under the hood. - Watch the gallery → or add /video to any diagram URL, such as gitdiagram.com/owner/repo/video. - Download an MP4 in landscape or vertical (9:16), with captions burned in. - Making new videos is in early access. Anyone can watch videos that already exist. Features - Watch a repository explained in a narrated video, or press Video on any diagram page. - Explore the architecture with an AI-generated diagram and streamed explanation. - Jump to the code by clicking any component's linked file or directory. - Use private repositories with a GitHub token via Private Repos in the header. - Export diagrams as PNG or copy the Mermaid source. Use GitDiagram from AI agents GitDiagram is a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in). Agents can read a public repository's architecture explanation, components, connections and Mermaid source, search the stored diagrams, and get explainer videos. bash Claude Code: the plugin adds the MCP server and a /gitdiagram skill claude plugin marketplace add ahmedkhaleel2004/gitdiagram claude plugin install gitdiagram@gitdiagram ...or just the MCP server claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp Codex codex mcp add gitdiagram --url https://gitdiagram.com/mcp Gemini CLI gemini extensions install https://github.com/ahmedkhaleel2004/gitdiagram GitHub Copilot CLI copilot mcp add --transport http gitdiagram https://gitdiagram.com/mcp In other clients (ChatGPT, Windsurf, Zed, LM Studio, Goose and more), add a remote MCP server with the URL https://gitdiagram.com/mcp. Then ask something like "how is fastapi/fastapi structured?". Run locally Requires Bun, Cloudflare R2, Upstash Redis, and an OpenAI or OpenRouter API key. See the setup guide for prerequisites and configuration. bash git clone https://github.com/ahmedkhaleel2004/gitdiagram.git cd gitdiagram bun install cp .env.example .env Fill in .env using the configuration guide, then start the app: bash bun run dev Open localhost:3000. Explainer videos are off by default. To turn them on, set VIDEO_EXPLAINER_ENABLED=1, NEXT_PUBLIC_VIDEO_EXPLAINER=1, ANTHROPIC_API_KEY, OPENAI_API_KEY and OPENROUTER_API_KEY (for the voice) in .env. See .env.example for the other video settings.
Top issues
#4Option to use it as a cli for local repo14 comments · 2024-12-28#179Adding OpenRouter as LLM providers with option to add desired LLM model3 comments · 2026-06-01#101Doesn't support branches3 comments · 2025-05-17#120Can it support other repo like Bitbucket, GitLab or private repos?2 comments · 2025-07-21#67Upload Docker Image to Docker Hub or Github container registry (ghcr.io)1 comments · 2025-04-03#230Feature: Generate diagrams for a specific commit (or ref)1 comments · 2026-10-17#228Bug: On ultra-wide monitors, your page only renders the diagram as a very small portion of the whole screen size1 comments · 2026-10-13#126How to use Gemini API key with GitDiagram?1 comments · 2025-08-28