GitWhy

Was ist GitWhy?

GitWhy ist eine „Context-Schicht“ für Git, die die Begründung hinter KI-generiertem Code speichert und teilt, direkt verknüpft mit den Commits, die sie erzeugt haben. Das Ziel ist es, Prompts, Entscheidungen und Abwägungen zusammen mit den Code-Änderungen überprüfbar zu machen, statt diese Infos nur in einem Chat-Fenster zu belassen.

Es erfasst strukturierten Kontext (wie den Original-Prompt, die Begründung, Entscheidungen und abgelehnte Alternativen) und verknüpft diesen Kontext mit Commits. Das Produkt zeigt die gespeicherte Begründung dann in Pull Requests an, damit Reviewer verstehen, warum Änderungen vorgenommen wurden – nicht nur den Diff.

Wichtige Funktionen

• Strukturierte „Begründungs“-Kontexte: Speichert ein festes Format inklusive Prompt, Begründung, Entscheidungen, abgelehnte Alternativen, Dateien und Commits, um Ausgaben konsistent über Läufe hinweg zu halten.
• Verknüpft mit Commits (git-nativer Nachweis): Jeder gespeicherte Kontext ist an die exakten Commits gebunden, die ihn erzeugt haben, sodass die Dokumentation fest im Code-Verlauf verankert bleibt.
• Anzeige in PRs via gitwhy-bot: Schiebt die vollständige Begründung als PR-Kommentare in Pull Requests, um Review-Kontext während der Code-Überprüfung verfügbar zu machen.
• Cloud-Sync und Teilen: Synchronisiert gespeicherte Kontexte in die Cloud, damit Teams sie organisationsweit teilen können.
• Suche über gespeicherte Kontexte: Ermöglicht die Suche in gespeicherter Begründung nach Keyword, Domain oder Thema, um frühere Entscheidungen schnell zu finden.
• Funktioniert mit MCP-kompatiblen Agents: Entwickelt für alle MCP-kompatiblen Agents (die Seite nennt explizit Claude Code, Cursor, Windsurf und Cline).
• Terminal-UI für Management: Bietet eine interaktive Terminal-Oberfläche zum Durchsuchen, Suchen und Verwalten von Kontexten ohne Browser.

So nutzt du GitWhy

1. Generiere Code mit einem MCP-kompatiblen Agent und stelle sicher, dass der Agent Begründungen erzeugt, die erfasst werden sollen.
2. Speichere den Begründungs-Kontext, wobei GitWhy die strukturierten Elemente (Prompt, Begründung, Entscheidungen, abgelehnte Alternativen, Dateien und Commits) aufzeichnet und mit den relevanten Commits verknüpft.
3. Sync in die Cloud (für Team-Sharing) und öffne dann einen Pull Request.
4. Review in der PR: Der GitWhy-Bot postet die gespeicherte Begründung in den Pull Request, damit Reviewer die zugrunde liegenden Entscheidungen und Abwägungen lesen können.

Anwendungsfälle

• PR-Review für KI-unterstützte Änderungen: Bei KI-generiertem Code können Reviewer die gespeicherte Begründung und Entscheidungen im PR-Kommentar lesen, statt Absichten aus dem Diff zu erschließen.
• Team-Wissensspeicherung für wiederkehrende Design-Entscheidungen: Authentifizierung, Datenbank- und API-Design-Entscheidungen können in einem nach Domain/Thema organisierten Kontext-Baum gespeichert werden, um vergangene Begründungen wiederzuverwenden.
• Audit des „Warum“ hinter spezifischen Commits: Da jeder Kontext mit den erzeugenden Commits verknüpft ist, können Entwickler die Herkunft einer Entscheidung zu den exakten Code-Änderungen zurückverfolgen.
• Schnellere Abruf bei neuer Arbeit: Suche in gespeicherten Kontexten nach Keyword, Domain oder Thema über Terminal, Agent oder Team-Dashboard, um relevante Begründungen schnell zu finden.
• Multi-Agent-Workflows: Teams mit verschiedenen MCP-kompatiblen Agents können Begründungen zentral erfassen und verwalten, ohne auf eine einzige Chat-Oberfläche angewiesen zu sein.

FAQ

• Welche Informationen speichert GitWhy pro Kontext? Die Seite beschreibt ein strukturiertes Format inklusive Prompt, Begründung, Entscheidungen, abgelehnte Alternativen, Dateien und Commits.

• Wie verknüpft GitWhy Begründung mit Code? Es verknüpft jeden gespeicherten Kontext mit den exakten Commits, die ihn erzeugt haben.

• Wo sehen Reviewer die Begründung? Der GitWhy-Bot postet die vollständige Begründung als PR-Kommentare in Pull Requests.

• Kann es ohne Browser genutzt werden? Ja. Das Produkt enthält eine interaktive Terminal-UI zum Durchsuchen, Suchen und Verwalten von Kontexten.

• Welche Agents werden unterstützt? Die Seite gibt an, es funktioniert mit allen MCP-kompatiblen Agents und nennt speziell Claude Code, Cursor, Windsurf und Cline.

Alternativen

• Normale PR-Beschreibungen oder Kommentare: Teams können die Begründung manuell in den PR-Text einfügen, aber das speichert nicht automatisch eine strukturierte, mit Commits verknüpfte Historie, warum Änderungen vorgenommen wurden.
• Externe Dokumentationssysteme (Wikis/Wissensbasen): Teams können Entscheidungsdokumente separat pflegen, aber diese sind nicht inherent mit Commits verknüpft oder werden nicht automatisch in PRs angezeigt.
• Lokale Log-/Chatverlaufsprüfung: Das Lesen früherer Chat-Protokolle kann Kontext liefern, ist aber weniger durchsuchbar und in der Regel nicht mit den Commits in der Repository-Historie verbunden.
• Allgemeine Code-Review-Tools mit Annotationen: Tools, die Diffs annotieren, können Änderungen erklären, aber der Quellentext hier betont strukturierte, mit Commits verknüpfte Begründungen und das Posten in PRs durch gitwhy-bot, was von generischen Review-Tools möglicherweise nicht abgedeckt wird.