gitdiagram

Visualize any GitHub codebase: free interactive architecture diagrams and one-minute explainer videos. Replace 'hub' with 'diagram' in any GitHub URL.

What is gitdiagram?

Visualize any GitHub codebase: free interactive architecture diagrams and one-minute explainer videos. Replace 'hub' with 'diagram' in any GitHub URL.

Overview of gitdiagram

What it is

GitDiagram turns any public or private GitHub repository into an interactive architecture diagram, or a one-minute narrated explainer video. It works by replacing 'hub' with 'diagram' in any GitHub repository URL. AI agents can also use it through a remote MCP server or the Markdown version of any diagram (gitdiagram.com/owner/repo.md).

Key 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.
  • AI agents can use GitDiagram through a remote MCP server at https://gitdiagram.com/mcp (no key or sign-in).
  • Explainer videos can be downloaded as MP4 in landscape or vertical (9:16) with captions burned in.

Use cases

  • Quickly understand the architecture of any public or private GitHub repository.
  • Get a narrated overview of a project's purpose, main parts, and key decisions.
  • AI agents analyze codebase structure, components, connections, and stored diagrams.
  • Developers explore unfamiliar codebases by clicking components to jump to code.

Getting started

To use GitDiagram, replace 'hub' with 'diagram' in any GitHub repository URL. For local development, clone the repository and run the following commands. 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 bun run dev Open localhost:3000. Explainer videos are off by default; to enable them, set the required environment variables as described in the repository.

License and pricing

Licensed under MIT. Open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ahmedkhaleel2004gitdiagram.svg)](https://yunodb.com/tools/ahmedkhaleel2004gitdiagram?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ahmedkhaleel2004gitdiagram?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ahmedkhaleel2004gitdiagram.svg" alt="Featured on YunoDB" height="20"></a>