GitHub

Voraussetzungen

• Ein GitHub-Konto mit Zugriff auf die Repositories, die Sie verbinden möchten
• Owner- oder Admin-Berechtigung auf der Organisation bzw. dem persönlichen Account, um die GitHub-App zu installieren

GitHub-App installieren

Die Verbindung zu GitHub erfolgt über die KI-DACH GitHub-App. Es ist kein manuelles Erstellen von Tokens oder Webhooks nötig — alles wird automatisch konfiguriert.

1. Öffnen Sie das KI-DACH-Dashboard und navigieren Sie zu Integrationen > GitHub.

2. Klicken Sie auf GitHub-App installieren.

3. Sie werden zu GitHub weitergeleitet. Wählen Sie den Account oder die Organisation aus, für die Sie die App installieren möchten.

4. Legen Sie fest, auf welche Repositories KI-DACH Zugriff haben soll — entweder alle Repositories oder nur ausgewählte Repositories.

5. Klicken Sie auf Install. Sie werden automatisch zum KI-DACH-Dashboard zurückgeleitet.

Nach der Installation werden Ihre Repositories automatisch synchronisiert und in der Übersicht angezeigt.

Repositories konfigurieren

Nach der Installation können Sie für jedes Repository individuell festlegen, welche Funktionen aktiv sein sollen. Aktivieren Sie ein Repository über den Schalter in der Repository-Liste.

Pull-Request-Reviews

• Automatisch bei Erstellung — KI-DACH Agent erstellt automatisch ein Review, wenn ein neuer Pull Request geöffnet wird.
• Bei Label — KI-DACH Agent erstellt ein Review, wenn das Label ki-dach dem Pull Request zugewiesen wird.

Issue-Automatisierung

• Bei Label — KI-DACH Agent verarbeitet Issues, die mit dem Label ki-dach versehen werden.

Hinweis

Wenn Sie ein Repository zum ersten Mal aktivieren, sind alle Optionen standardmäßig eingeschaltet. Sie können die Einstellungen danach jederzeit anpassen.

Repository-Zugriff anpassen

Falls Sie den Zugriff der GitHub-App nachträglich ändern möchten (z.B. weitere Repositories freigeben):

1. Öffnen Sie die GitHub-Integration im KI-DACH-Dashboard.

2. Klicken Sie auf Zugriff konfigurieren bei der betroffenen Installation. Sie werden zu den GitHub-App-Einstellungen weitergeleitet.

3. Passen Sie die Repository-Auswahl an und speichern Sie.

4. Zurück im KI-DACH-Dashboard, klicken Sie auf Repositories synchronisieren, um die Änderungen zu übernehmen.

Verbindung entfernen

Um die GitHub-Integration zu trennen:

1. Öffnen Sie die GitHub-Integration im KI-DACH-Dashboard.

2. Klicken Sie auf die Option zum Entfernen der Verbindung.

3. Bestätigen Sie die Aktion. Alle Repositories dieser Installation werden deaktiviert.

Alternativ können Sie die KI-DACH GitHub-App auch direkt in den GitHub-App-Einstellungen Ihres Accounts deinstallieren.

Fehlerbehebung

Kein Repository-Zugriff

Die GitHub-App hat keinen Zugriff auf Repositories.

• Prüfen Sie, ob die App auf die gewünschten Repositories Zugriff hat
• Öffnen Sie Zugriff konfigurieren und wählen Sie die entsprechenden Repositories aus
• Klicken Sie anschließend auf Repositories synchronisieren

KI-DACH reagiert nicht auf Pull Requests oder Issues

• Stellen Sie sicher, dass das Repository in der KI-DACH-Übersicht aktiviert ist
• Prüfen Sie, ob die gewünschte Funktion (Reviews / Issues) für das Repository eingeschaltet ist
• Bei Label-basierter Auslösung: Stellen Sie sicher, dass das Label ki-dach korrekt zugewiesen wurde
• Klicken Sie auf Repositories synchronisieren, um sicherzustellen, dass die Konfiguration aktuell ist

Repositories werden nicht angezeigt

• Klicken Sie auf Repositories synchronisieren in der Integrationsübersicht
• Falls das Repository weiterhin fehlt, überprüfen Sie den Repository-Zugriff in den GitHub-App-Einstellungen