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
TypeScriptMITCreated 2024-12-15gitdiagram.com
+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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON