Was ist GitDiagram?
GitDiagram ist eine Web-App und ein quelloffenes Next.js-Projekt von Ahmed Khaleel, das ein GitHub-Repository in ein interaktives Architekturdiagramm verwandelt. Ein KI-Modell liest den Dateibaum des Repositorys, das README und bis zu 12 Quelldateien, schreibt eine kurze Übersicht und liefert dann einen Graphen mit höchstens 34 gruppierten Komponenten und beschrifteten Verbindungen. Jeder verlinkte Pfad wird gegen den echten Baum geprüft, bevor der Graph zu Mermaid kompiliert wird, und jede Komponente öffnet ihre Datei oder ihren Ordner auf GitHub.
Diagramme werden gespeichert und geteilt, ein Repository, das schon jemand diagrammiert hat, öffnet sich also sofort. Die Seite erstellt außerdem gesprochene Erklärvideos von etwa einer Minute, exportiert PNG oder Mermaid-Quelltext, bietet unter gitdiagram.com/owner/repo.md eine Markdown-Fassung jedes gespeicherten Diagramms und betreibt unter gitdiagram.com/mcp einen kostenlosen, schreibgeschützten Remote-MCP-Server. Private Repositories funktionieren mit einem schreibgeschützten GitHub-Token.
Das Repository wurde im Dezember 2024 angelegt, steht unter MIT-Lizenz und hat etwa 18.700 GitHub-Sterne und 1.430 Forks. Es veröffentlicht keine getaggten Releases; der letzte Commit war am 30. Oktober 2026.
Lohnt sich GitDiagram?
Der Wert von GitDiagram liegt im Ablauf ohne Arbeitsschritte: nichts klonen, nichts installieren, für die meisten Zwecke kein Schlüssel und am Ende ein teilbarer Link. Die Pipeline dahinter ist sorgfältiger, als der URL-Trick vermuten lässt. Laut Architekturdokumentation streamt eine einzige Anfrage an GPT-6 Luna mit niedrigem Reasoning eine Übersicht und einen strikten Graphen; der Server prüft Bezeichner, Zusammenhang und jeden verlinkten Pfad gegen das tatsächliche Repository, wiederholt ungültige Ausgaben mit Rückmeldung, und ein deterministischer Compiler, nicht das Modell, schreibt das Mermaid. Der Browser bereinigt danach das SVG und lässt nur Links zu GitHub zu. Dadurch sind die Links verlässlich, auch wenn die Zeichnung es nicht ist.
Die Obergrenze ist eingebaut. Das Modell sieht einen begrenzten Ausschnitt des Baums, das README und höchstens 12 Quelldateien und zeichnet nicht mehr als 34 Komponenten. Für eine kleine Bibliothek reicht das; für ein Monorepo mit Dutzenden Diensten heißt das ein grobes Bild, in dem ganze Pakete zu einem Kasten zusammenfallen, und der eigene Leitfaden des Projekts nennt es eine Karte der wichtigen Teile, keinen vollständigen Abhängigkeitsgraphen. Sehr große Repositories, die GitHub als abgeschnittenen Baum liefert, bekommen trotzdem ein Diagramm aus einer Teilliste, und ein zu großes README wird sofort abgelehnt. Ein gespeichertes Diagramm friert das Repository außerdem in seinem damaligen Zustand ein; Regenerate erstellt ein neues.
Der Umgang der gehosteten Seite mit Daten ist in ihrer Datenschutzerklärung klar dokumentiert. Repository-Inhalte gehen an OpenAI, Anthropic und OpenRouter, um zu erstellen, was du angefordert hast. Private Repositories brauchen ein Fine-grained Token mit Contents nur lesend oder eine Anmeldung über Continue with GitHub, beschränkt auf die Repositories, die du auswählst; das Token liegt bis zu 30 Tage in einem HttpOnly-Cookie und wird nie auf dem Server gespeichert, und private Diagramme liegen in einem eigenen Namensraum. Auf der Seite laufen Sitzungsaufzeichnungen von PostHog, Eingaben werden dabei maskiert. Das README und die Markdown-Fassung enthalten bezahlte Sponsorenplätze, zum Zeitpunkt des Schreibens CodeRabbit.
Die Videos sind der teure Teil und werden entsprechend rationiert. Claude Opus schreibt das Skript, Claude Haiku 5.5 gestaltet die Szenen, Gemini 3.8 Flash TTS über OpenRouter liest es vor und whisper-1 setzt die Wortzeiten; die Standardgrenzen sind ein neues Video pro Browser und 25 auf der ganzen Seite pro UTC-Tag, darüber hinaus $3 für eines. Im Vergleich zu DeepWiki, das ein mehrseitiges Wiki mit Chat schreibt, beantwortet GitDiagram eine engere Frage schneller, und ein Coding-Agent in deinem eigenen Checkout zeichnet ein genaueres Diagramm von privatem oder nicht committetem Code.
Wo es sich lohnt
Eine Backend-Entwicklerin, die drei quelloffene Job-Queue-Bibliotheken vergleicht
Sehen, wie jede aufgebaut ist, bevor sie Code liest
In jeder GitHub-URL 'hub' durch 'diagram' ersetzen; gespeicherte Diagramme öffnen sich sofort, neue brauchen etwa eine Minute. Ein Klick auf eine Komponente springt zu ihrem Ordner. Kostenlos innerhalb des Tageslimits; danach zahlt dein eigener OpenAI-Schlüssel.
Ein Entwickler, der Claude Code oder Codex für eine Aufgabe nutzt, die eine unbekannte Abhängigkeit berührt
Dem Agenten die Struktur der Abhängigkeit geben, ohne ihren Quellcode einzufügen
Den Remote-MCP-Server mit einem Befehl hinzufügen und den Agenten fragen, wie das Projekt aufgebaut ist; er liest die gespeicherte Übersicht, Komponenten, Verbindungen und den Mermaid-Quelltext. Kostenlos, standardmäßig auf 120 Tool-Aufrufe pro Stunde und Netzwerk begrenzt und nur für öffentliche Repositories.
Eine Developer-Relations-Leiterin in einem Open-Source-Unternehmen mit 20 Leuten
Ein Architekturbild und ein kurzes Erklärvideo ins README des Projekts bringen
Das Diagramm als PNG exportieren oder den Mermaid-Quelltext als ersten Entwurf zum Bearbeiten kopieren und das Erklärvideo als MP4 im Querformat oder in 9:16 mit eingebrannten Untertiteln herunterladen. Ein Video über das kostenlose Tageskontingent hinaus kostet $3.
Bevor du dich festlegst
- Einrichtung
- Gehostet: die URL ändern oder owner/repo auf der Startseite einfügen; etwa eine Minute für ein neues Diagramm. Selbst gehostet: Bun 1.3.14 und Node 22, bun install, dann .env mit Cloudflare-R2-Buckets, Upstash Redis, CACHE_KEY_SECRET und einem OpenAI- oder OpenRouter-Schlüssel füllen, bevor bun run dev läuft.
- Integrationen
- Remote-MCP-Server (get_repository_diagram, find_repository_diagrams, get_explainer_video) für Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, GitHub Copilot CLI und ChatGPT; ein Claude-Code-Plugin mit einem Skill /gitdiagram; Markdown unter /owner/repo.md; Export als PNG und Mermaid.
- Daten und Datenschutz
- Diagramme und Videos öffentlicher Repositories werden für alle veröffentlicht, die das Repository öffnen. Repository-Inhalte gehen an OpenAI, Anthropic und OpenRouter. GitHub-Tokens und OpenAI-Schlüssel bleiben bis zu 30 Tage in einem HttpOnly-Cookie im Browser, nie auf dem Server; das empfohlene Token ist Fine-grained mit Contents nur lesend. Auf der Seite laufen PostHog-Analysen und Sitzungsaufzeichnungen. MIT-Lizenz.
- Kosten im großen Maßstab
- Die gehostete Seite hat kein Abo. Selbst-Hosting heißt, für R2, Upstash und die Modell-Tokens pro Diagramm zu zahlen; das Projekt veröffentlicht keine Kosten pro Diagramm, die App zeigt aber vor jedem Lauf eine Schätzung, und eine optionale Fast-Spur verdoppelt den Modellpreis. Videos kommen mit Aufrufen an Anthropic, OpenAI und OpenRouter sowie Renderings in Headless Chromium dazu.
- Grenzen
- Die Standardwerte im Code erlauben 8 vom Server bezahlte Generierungen pro IP und Stunde (wer einen eigenen Schlüssel nutzt, ist ausgenommen) und für alle 60 Aufrufe pro Stunde an die Generierungs-Endpunkte. Eine Generierung hat ein Budget von 300 Sekunden. Das Erstellen neuer Videos ist im Early Access, mit Tageslimits. Etwa 55 offene Issues und Pull Requests; keine getaggten Releases.
Was gut ist
- Funktioniert durch Ändern einer URL; nichts zu klonen oder zu installieren
- Jeder verlinkte Pfad wird gegen das echte Repository geprüft
- Deterministischer Mermaid-Compiler und Link-Allowlist nur für GitHub
- Kostenloser schreibgeschützter MCP-Server und Markdown-Fassung für Agenten
Was nicht
- Höchstens 12 Quelldateien und 34 Komponenten, grob bei Monorepos
- Gespeicherte Diagramme veralten, bis jemand sie neu erzeugt
- Selbst-Hosting braucht Cloudflare R2, Upstash Redis und einen Modellschlüssel
- Sponsorenplätze im README und in der Markdown-Ausgabe
Am besten für
Entwickler, die ein unbekanntes GitHub-Repository einschätzen wollen, und Agenten, die eine schnelle Strukturübersicht eines öffentlichen Repositorys brauchen, bevor jemand den Code öffnet.
Alternativen zu GitDiagram
GitDiagram: häufige Fragen
- Lohnt sich GitDiagram?
- GitDiagram liefert dir eine brauchbare erste Karte eines unbekannten Repositorys in der Zeit, die das Ändern einer URL dauert, solange du sie als Skizze und nicht als Bauplan behandelst. Wir bewerten es mit 4.0 von 5.
- Was kostet GitDiagram?
- Kostenlos nutzbar und Open Source (MIT). Neue Diagramme sind innerhalb eines Tageslimits gratis und brauchen danach deinen eigenen OpenAI-API-Schlüssel; Erklärvideos über das kostenlose Tageskontingent hinaus kosten je $3.
- Welche Nachteile hat GitDiagram?
- Höchstens 12 Quelldateien und 34 Komponenten, grob bei Monorepos; Gespeicherte Diagramme veralten, bis jemand sie neu erzeugt; Selbst-Hosting braucht Cloudflare R2, Upstash Redis und einen Modellschlüssel; Sponsorenplätze im README und in der Markdown-Ausgabe.
- Für wen eignet sich GitDiagram?
- Entwickler, die ein unbekanntes GitHub-Repository einschätzen wollen, und Agenten, die eine schnelle Strukturübersicht eines öffentlichen Repositorys brauchen, bevor jemand den Code öffnet.
- Was kostet GitDiagram für ein Team oder im Produktivbetrieb?
- Die gehostete Seite hat kein Abo. Selbst-Hosting heißt, für R2, Upstash und die Modell-Tokens pro Diagramm zu zahlen; das Projekt veröffentlicht keine Kosten pro Diagramm, die App zeigt aber vor jedem Lauf eine Schätzung, und eine optionale Fast-Spur verdoppelt den Modellpreis. Videos kommen mit Aufrufen an Anthropic, OpenAI und OpenRouter sowie Renderings in Headless Chromium dazu.
- Ist GitDiagram sicher für Firmendaten?
- Diagramme und Videos öffentlicher Repositories werden für alle veröffentlicht, die das Repository öffnen. Repository-Inhalte gehen an OpenAI, Anthropic und OpenRouter. GitHub-Tokens und OpenAI-Schlüssel bleiben bis zu 30 Tage in einem HttpOnly-Cookie im Browser, nie auf dem Server; das empfohlene Token ist Fine-grained mit Contents nur lesend. Auf der Seite laufen PostHog-Analysen und Sitzungsaufzeichnungen. MIT-Lizenz.
- Was sind die besten Alternativen zu GitDiagram?
- Die nächsten Alternativen, die wir getestet haben, sind OpenWiki, Archify und Repomix.
Antworten geprüft am 31. Okt. 2026.