GitDiagram
Turn any GitHub repository into an interactive Mermaid architecture diagram or a narrated video explainer.
Convert GitHub repos into interactive system architecture diagrams, Markdown summaries, or short videos.
GitDiagram converts GitHub repositories into visual architecture diagrams and short narrated explainer videos. You can use it directly in your browser by replacing 'hub' with 'diagram' in any GitHub URL, or hook it into AI agents via Model Context Protocol (MCP).
What it is
GitDiagram inspects public or private GitHub repositories to generate interactive Mermaid system diagrams with clickable links to source files. It offers a streaming written architectural breakdown, downloadable MP4 video summaries with audio narration, and a raw Markdown format for LLM consumption.
Who it's for
This tool suits software engineers, system architects, and technical leads who need to quickly comprehend unfamiliar codebases or create documentation. It is not suitable if you need offline execution without cloud infrastructure, as local hosting requires external cloud storage, Redis, and LLM API keys.
Key features
Interactive architecture diagrams
Generates visual Mermaid diagrams with clickable elements that jump directly to linked files or directories on GitHub.
Narrated video explainers
Produces short, caption-rendered MP4 video summaries explaining system design, core use cases, and underlying technical decisions.
Remote MCP integration
Connects AI coding assistants like Claude, Cursor, and Copilot directly to repo diagrams via a hosted MCP endpoint.
Private repository access
Supports analysis of private GitHub repositories through personal access tokens.
Exportable diagram source
Exports generated architecture diagrams as PNG files, raw Mermaid syntax, or Markdown files.
Up and running in 3 steps
Our honest verdict
What's great
- Instant URL conversion by replacing 'hub' with 'diagram' in GitHub repo links
- Direct integration with AI coding clients through a zero-config remote MCP server
- Interactive diagram components link directly to matching code files in GitHub
- Exports diagrams into reusable Mermaid source code and PNG formats
Where it falls short
- Self-hosting requires paid or configured third-party services including Cloudflare R2, Upstash Redis, and LLM API keys
- Creating new video explainers locally requires multiple API keys across OpenAI, Anthropic, and OpenRouter
- Video generation feature is in early access
- Requires active cloud API access to synthesize diagrams, preventing fully offline air-gapped usage
Pricing & license
GitDiagram is open-source under the MIT license and free to use online at gitdiagram.com. Self-hosting costs depend on your usage of required third-party services like OpenAI, OpenRouter, Anthropic, Upstash Redis, and Cloudflare R2.
Open remote AI-training roles
768 open remote AI-training roles, updated November 14, 2026; most pay $20–$175 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
Use it, or have us set it up
FAQ
How do I analyze a private repository?
You can supply a GitHub personal access token using the Private Repos option in the header.
How do I connect GitDiagram to my AI coding agent?
Add https://gitdiagram.com/mcp as an HTTP remote MCP server in tools like Cursor, Claude Code, VS Code, or Copilot.
What APIs are required to host GitDiagram locally?
Local hosting requires credentials for Bun, Cloudflare R2, Upstash Redis, and an OpenAI or OpenRouter API key, plus Anthropic for video creation.
