git-lrc

git-lrc: Ihr KI-Bremssystem für sichere Git Commits

In der heutigen Zeit fungiert generative KI oft wie ein Rennwagen ohne Bremsen. Tools wie Cursor oder Copilot beschleunigen die Entwicklung massiv, doch KI-Agenten können auch unbemerkt Fehler einführen. Sie entfernen Logik, lockern Sicherheitsbeschränkungen, lecken Zugangsdaten oder verursachen teure Cloud-Aufrufe. git-lrc ist die Lösung für dieses Problem. Als spezialisiertes Tool für KI-gestützte Code-Reviews klinkt es sich direkt in Ihren Git-Workflow ein und prüft jede Änderung, bevor sie dauerhaft gespeichert wird.

Was ist git-lrc?

git-lrc ist ein Open-Source-Tool, das als Git Hook fungiert, um automatische KI-Reviews bei jedem Commit durchzuführen. Es dient als Sicherheitsnetz für Entwickler, die KI-Tools nutzen, und stellt sicher, dass kein fehlerhafter oder unsicherer Code in das Repository gelangt. Da es auf der Gemini API von Google basiert, bietet es eine unbegrenzte Anzahl an Reviews völlig kostenlos an – Sie bringen lediglich Ihren eigenen API-Key mit.

Durch die Integration von git-lrc wird der Review-Prozess zu einer festen Gewohnheit. Da Git universell in fast jedem Editor und jeder IDE eingesetzt wird, stellt die Verknüpfung mit dem Commit-Befehl sicher, dass kein Review übersehen wird.

Features von git-lrc

git-lrc bietet eine umfassende Suite an Funktionen, die darauf ausgelegt sind, die Codequalität zu maximieren, ohne den Workflow zu verlangsamen:

• Automatischer Review-Trigger: git-lrc startet automatisch eine Analyse Ihres Diffs, sobald Sie git commit ausführen.
• Detaillierte Diff-Ansicht: Eine Benutzeroberfläche im GitHub-Stil zeigt farbcodierte Hinzufügungen und Löschungen.
• Inline-KI-Kommentare: Die KI platziert Anmerkungen direkt an den relevanten Codezeilen, inklusive Schweregrad-Badges.
• Identifikation kritischer Probleme: Das Tool erkennt zuverlässig:
  • Geleakte Zugangsdaten (Credentials)
  • Teure Cloud-Operationen
  • Sensible Daten in Protokollen (Logs)
  • Unbeabsichtigte Logik-Entfernung
  • Verhaltensänderungen im Code
• Nahtlose Navigation: Wechseln Sie zwischen Dateien, scrollen Sie durch Kommentare oder kopieren Sie alle gefundenen Probleme mit einem Klick, um sie zurück in Ihren KI-Agenten zu speisen.
• Transparente Git-Logs: Jede Prüfung wird im Git-Log vermerkt (z. B. ran (iter:3, coverage:85%)), sodass das Team genau sieht, welcher Code geprüft wurde.
• Vouch-Funktion: Übernehmen Sie explizit die Verantwortung für Änderungen, auch ohne KI-Review.

Wie man git-lrc installiert

Die Einrichtung von git-lrc ist denkbar einfach und dauert weniger als eine Minute. Es wird maschinenweit installiert, sodass es für alle Ihre Repositories sofort verfügbar ist.

1. Installation des Binaries

Nutzen Sie den folgenden Befehl für macOS oder Linux:

curl -fsSL https://hexmos.com/lrc-install.sh | sudo bash

2. Einmaliges Setup

Führen Sie den Setup-Befehl aus:

git lrc setup

Folgen Sie den Anweisungen im Browser, um Ihren LiveReview API-Key (via Hexmos) und Ihren kostenlosen Gemini API-Key (via Google AI Studio) zu hinterlegen.

So verwenden Sie git-lrc

Es gibt zwei Hauptwege, wie Sie git-lrc in Ihren täglichen Arbeitsablauf integrieren können:

Option A: Automatischer Review beim Commit

Dies ist der Standardweg, um sicherzustellen, dass nichts vergessen wird:

1. Fügen Sie Ihre Änderungen hinzu: git add .
2. Starten Sie den Commit: git commit -m "Ihr Kommentar"
3. Das git-lrc Review-Interface öffnet sich automatisch im Browser.

Option B: Manueller Review vor dem Commit

Wenn Sie den Review-Zyklus manuell steuern möchten:

1. git add .
2. git lrc review ausführen, um die Analyse zu starten.
3. Nutzen Sie git lrc review --vouch, wenn Sie die Änderungen manuell absegnen wollen, oder git lrc review --skip, um den Prozess zu überspringen.
4. Nach erfolgreichem Review committen Sie wie gewohnt.

Pro-Tipp: Sie können git-lrc nutzen, um Probleme zu finden, diese an Ihren KI-Agenten (wie Cursor oder Copilot) zurückzugeben, den Code zu fixen und den Review-Zyklus zu wiederholen, bis alles perfekt ist.

Anwendungsfälle (Use Cases)

• Schutz vor KI-Fehlern: Wenn Sie große Codeblöcke mit KI generieren, hilft git-lrc dabei, versteckte Verschlechterungen oder gelöschte Edge-Cases zu finden.
• Sicherheits-Audit: Verhindern Sie, dass Passwörter oder API-Schlüssel versehentlich in das Repository hochgeladen werden.
• Teamentwicklung: Erstellen Sie eine nachvollziehbare Historie im Git-Log, die zeigt, wie intensiv Code vor dem Mergen geprüft wurde.
• Lernwerkzeug: Durch die Inline-Kommentare der KI lernen Entwickler sofort, welche Best Practices sie eventuell übersehen haben.

Schnellreferenz der Befehle

| Befehl | Beschreibung | | :--- | :--- | | lrc oder lrc review | Überprüft gestagte Änderungen | | lrc review --vouch | Bestätigen ohne KI, persönliche Verantwortung übernehmen | | lrc review --skip | Review für diesen Commit überspringen | | lrc review --commit HEAD | Letzten Commit nachträglich prüfen | | lrc hooks disable | Deaktiviert Hooks für das aktuelle Repo | | lrc hooks enable | Reaktiviert Hooks | | lrc self-update | Aktualisiert git-lrc auf die neueste Version |

FAQ (Häufig gestellte Fragen)

Welche Daten werden an die KI gesendet? Nur der gestagte Diff (die Änderungen) wird analysiert. Es wird kein vollständiger Repository-Kontext hochgeladen und die Diffs werden nach dem Review nicht gespeichert.

Warum ist git-lrc kostenlos? git-lrc ist quelloffen (source-available) und nutzt die Gemini API. Da Sie Ihren eigenen Key verwenden, entstehen keine Vermittlerkosten. Der Koordinationsdienst LiveReview ist für unbegrenzte Reviews kostenlos.

Kann ich git-lrc für ein einzelnes Projekt deaktivieren? Ja, nutzen Sie einfach den Befehl git lrc hooks disable innerhalb des entsprechenden Verzeichnisses.

Kann ich ältere Commits prüfen? Absolut. Mit git lrc review --commit HEAD~3..HEAD können Sie beispielsweise eine ganze Spanne von Commits analysieren lassen.