LibreAI / Dev Tools / gitdiagram
// devtools · ahmedkhaleel2004/gitdiagram

gitdiagram

Turn any GitHub repo into an interactive architecture diagram - just swap 'hub' for 'diagram'

★ 18.0k stars⑂ 1.4k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

gitdiagram is an open-source dev tools project by ahmedkhaleel2004 (ahmedkhaleel2004/gitdiagram on GitHub). It has 17,984 GitHub stars and 1,378 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
17,984
Forks
1,378
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Pick a repository

    Choose any public GitHub repo - or prepare a token for a private one.

  2. Get the diagram

    Use the hosted site by editing the repo URL, install the agent plugin, or clone to run locally.

  3. Configure if self-hosting

    For local runs, install dependencies with Bun and copy the example env file.

  4. Explore your first diagram

    Click components to jump to code, export a PNG, or watch the explainer video.

// features

Why people love it

Interactive architecture diagrams

AI-generated system diagrams you can explore, with streamed explanations of the codebase.

Click through to code

Every component links to the file or directory it represents in the repo.

Explainer videos

Generates a one-minute narrated video explaining the repository.

Private repo support

Use a GitHub token via the Private Repos option to diagram private codebases.

Exports

Export diagrams as PNG or copy the Mermaid source for docs and wikis.

Agent and MCP access

Plugins and an MCP server let Claude Code, Codex, Gemini CLI and Copilot CLI request diagrams directly.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
    cd gitdiagram
  2. Run it locally

    Clone, install with Bun, configure the environment, and start the dev server.

    bun install
    cp .env.example .env
    bun run dev
  3. Or add it to your agent

    The README provides plugin/MCP commands for Claude Code, Codex, Gemini CLI and Copilot CLI.

    claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp # see README for other agents
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by Ahmed Khaleel (ahmedkhaleel2004) and contributors on GitHub.

Is it free to use?

Yes - GitDiagram is MIT licensed, and the hosted diagrams for public repos are free; local runs need the API keys described in the env example.

Does it need a paid API key?

The hosted service needs no key for public repos (a GitHub token unlocks private repos). Self-hosting uses your own LLM/API credentials per the .env example.

How does it compare to alternatives?

Compared with static diagram generators, GitDiagram is repo-aware and interactive - components link to source - and adds videos and agent/MCP access.

How do I get started?

Take any GitHub URL, replace 'hub' with 'diagram', and explore - or clone and run it locally with Bun.

// keep exploring

Similar tools

Dev Tools

cartograph

Cartograph turns any GitHub repo into an interactive dependency map.

★ 42 starsCustom
View guide →
Dev Tools

repo2txt

Turn any GitHub repo into one formatted text file — perfect context for AI.

★ 1.8k starsCustom
View guide →
Dev Tools

mcp2cli

Turn any MCP server, OpenAPI spec or GraphQL endpoint into a CLI — at runtime, with zero codegen

★ 2.4k starsMIT
View guide →
Dev Tools

graphify

Turn any codebase, docs and schemas into a queryable knowledge graph for your coding assistant

★ 124.7k starsApache-2.0
View guide →
Dev Tools

OpenCLI

Turn any website into a CLI — and let AI agents drive your already-logged-in browser

★ 29.9k starsApache-2.0
View guide →
Dev Tools

agents-cli

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

★ 6.0k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if gitdiagram is not the right fit.

Get gitdiagram

Free and open — grab the source, star the repo, and start creating.