Skip to content
Back to search

gitdiagram

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ahmedkhaleel2004/gitdiagram with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ahmedkhaleel2004/gitdiagram'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahmedkhaleel2004--gitdiagram/badge.svg)](/listings/ahmedkhaleel2004--gitdiagram)

HTML

<a href="/listings/ahmedkhaleel2004--gitdiagram"><img src="/api/listings/ahmedkhaleel2004--gitdiagram/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "gitdiagram",
  3. "owner": {
  4. "name": "GitDiagram",
  5. "email": "ahmed@gitdiagram.com"
  6. },
  7. "metadata": {
  8. "description": "GitDiagram's plugin: architecture diagrams of any public GitHub repository."
  9. },
  10. "plugins": [
  11. {
  12. "name": "gitdiagram",
  13. "source": "./plugins/gitdiagram",
  14. "description": "Architecture diagrams, explanations and Mermaid source for any public GitHub repository, from gitdiagram.com.",
  15. "category": "development",
  16. "tags": ["architecture", "diagram", "mermaid", "github"]
  17. }
  18. ]
  19. }
README.md · README · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # GitDiagram
  2. 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](#use-gitdiagram-from-ai-agents) or the Markdown version of any diagram (`gitdiagram.com/owner/repo.md`).
  3. **[Try GitDiagram →](https://gitdiagram.com/)** · Or replace `hub` with `diagram` in any GitHub repository URL.
  4. [![GitDiagram front page](./docs/readme_img.png)](https://gitdiagram.com/)
  5. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. [![Ko-fi](https://img.shields.io/badge/Ko--fi-F16061.svg?logo=ko-fi&logoColor=white)](https://ko-fi.com/ahmedkhaleel2004)
  7. <!-- sponsor:start -->
  8. > <a href="https://gitdiagram.com/out/coderabbit-2026-10?placement=readme"><picture><source media="(prefers-color-scheme: dark)" srcset="./public/sponsors/coderabbit-wordmark-white.svg" /><img src="./public/sponsors/coderabbit-wordmark.svg" alt="CodeRabbit" width="156" align="middle" /></picture></a>&nbsp;&nbsp; <sub>Sponsored</sub>
  9. >
  10. > AI code reviews for your pull requests. [Try CodeRabbit →](https://gitdiagram.com/out/coderabbit-2026-10?placement=readme)
  11. <!-- sponsor:end -->
  12. ## New: explainer videos
  13. 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.
  14. [![Watch GitDiagram explain itself in a minute](./docs/readme_video.jpg)](https://gitdiagram.com/ahmedkhaleel2004/gitdiagram/video)
  15. - **[Watch the gallery →](https://gitdiagram.com/videos)** or add `/video` to any diagram URL, such as `gitdiagram.com/owner/repo/video`.
  16. - **Download an MP4** in landscape or vertical (9:16), with captions burned in.
  17. - **Making new videos is in early access.** Anyone can watch videos that already exist.
  18. ## Features
  19. - **Watch a repository explained** in a narrated video, or press **Video** on any diagram page.
  20. - **Explore the architecture** with an AI-generated diagram and streamed explanation.
  21. - **Jump to the code** by clicking any component's linked file or directory.
  22. - **Use private repositories** with a GitHub token via **Private Repos** in the header.
  23. - **Export diagrams** as PNG or copy the Mermaid source.
  24. ## Use GitDiagram from AI agents
  25. 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.
  26. [![Add to Claude](https://img.shields.io/badge/Claude-Add_connector-D97757?style=flat-square&logo=claude&logoColor=white)](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=GitDiagram&connectorUrl=https%3A%2F%2Fgitdiagram.com%2Fmcp)
  27. [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-000000?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/link/mcp/install?name=gitdiagram&config=eyJ1cmwiOiJodHRwczovL2dpdGRpYWdyYW0uY29tL21jcCJ9)
  28. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=gitdiagram&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fgitdiagram.com%2Fmcp%22%7D)
  29. [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=gitdiagram&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fgitdiagram.com%2Fmcp%22%7D&quality=insiders)
  30. ```bash
  31. # Claude Code: the plugin adds the MCP server and a /gitdiagram skill
  32. claude plugin marketplace add ahmedkhaleel2004/gitdiagram
  33. claude plugin install gitdiagram@gitdiagram
  34. # ...or just the MCP server
  35. claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp
  36. # Codex
  37. codex mcp add gitdiagram --url https://gitdiagram.com/mcp
  38. # Gemini CLI
  39. gemini extensions install https://github.com/ahmedkhaleel2004/gitdiagram
  40. # GitHub Copilot CLI
  41. copilot mcp add --transport http gitdiagram https://gitdiagram.com/mcp
  42. ```
  43. 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?".
  44. ## Run locally
  45. Requires [Bun](https://bun.sh/), Cloudflare R2, Upstash Redis, and an OpenAI or OpenRouter API key. See the [setup guide](docs/dev-setup.md) for prerequisites and configuration.
  46. ```bash
  47. git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
  48. cd gitdiagram
  49. bun install
  50. cp .env.example .env
  51. ```
  52. Fill in `.env` using the [configuration guide](docs/dev-setup.md#configure), then start the app:
  53. ```bash
  54. bun run dev
  55. ```
  56. Open [localhost:3000](http://localhost:3000).
  57. 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.
  58. ## Development
  59. Built with Next.js, React, TypeScript, Tailwind CSS, and Mermaid. Videos use Claude or GPT for the script and scenes and OpenRouter (Gemini 3.8 Flash TTS) for the voice. Deployed on Cloudflare Workers.
  60. - [Architecture](docs/architecture.md) — generation pipeline, storage, and API
  61. - [Development guide](docs/dev-setup.md) — setup, checks, and deployment
  62. - [Deployment recovery](docs/deployment-failover.md) — Railway/Docker fallback
  63. Contributions are welcome. Open an issue or pull request with a focused description and [verification notes](docs/dev-setup.md#verify).
  64. Inspired by [Romain Courtois](https://github.com/cyclotruc)'s [Gitingest](https://gitingest.com/).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.