TeamDay.ai
← Docs

Git-Integrationsleitfaden

Erfahren Sie, wie Sie Ihre GitHub-Repositories mit TeamDay Spaces verbinden und Ihren KI-Agenten ermöglichen, mit Versionskontrolle zu arbeiten.

Inhaltsverzeichnis

Was Sie lernen werden

Am Ende dieses Leitfadens werden Sie wissen, wie Sie:

  • ✅ GitHub OAuth-Authentifizierung einrichten
  • ✅ Private Repositories in Spaces klonen
  • ✅ Agenten Änderungen committen und pushen lassen
  • ✅ Branches und Pull Requests verwalten
  • ✅ Git-Anmeldedaten sicher konfigurieren
  • ✅ Merge-Konflikte handhaben

Zeit zum Abschließen: 15-20 Minuten

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:

Git in TeamDay verstehen

Wie Git in Spaces funktioniert

TeamDay Spaces haben eingebaute Git-Unterstützung, die es Ihnen ermöglicht, Repositories zu klonen, Änderungen zu verfolgen und direkt von der Benutzeroberfläche mit GitHub zu synchronisieren.

Jeder Space kann mehrere Git-Repositories enthalten. Wenn Sie ein Repo klonen, wird es in ein Unterverzeichnis in Ihrem Space platziert, was Ihre Projekte organisiert hält.

Space-Strukturbeispiel:

my-space/
├── CLAUDE.md           # Space-Konfiguration
├── my-webapp/          # Geklontes Repository
│   ├── .git/
│   ├── src/
│   └── package.json
└── another-repo/       # Ein weiteres geklontes Repository
    ├── .git/
    └── ...

Hauptfunktionen

Versionskontrolle

  • Vollständige Git-Funktionalität in jedem Space
  • Commit, Branch, Merge und Rebase
  • Komplette Historie-Verfolgung

GitHub-Integration

  • OAuth-Authentifizierung
  • Klonen Sie private Repositories
  • Pushen Sie Änderungen zurück zu GitHub
  • Automatische Anmeldedaten-Verwaltung

Agent-Fähigkeiten

  • Agenten können Repository-Dateien lesen
  • Änderungen mit aussagekräftigen Nachrichten committen
  • Branches erstellen und wechseln
  • Zu Remote-Repositories pushen

GitHub OAuth Setup

Bevor Sie private Repositories klonen können, müssen Sie Ihr GitHub-Konto mit TeamDay verbinden.

GitHub-Zugriff autorisieren

Schritt 1: Navigieren Sie zu Space-Einstellungen

  1. Öffnen Sie Ihren Space
  2. Gehen Sie zur Registerkarte Einstellungen
  3. Klicken Sie auf “Integrationen” in der Seitenleiste
  4. Finden Sie den Abschnitt “GitHub”

Schritt 2: Verbinden Sie GitHub

  1. Klicken Sie auf die Schaltfläche “GitHub verbinden”

  2. Sie werden zu GitHub weitergeleitet

  3. Überprüfen Sie die angeforderten Berechtigungen:

    • ✅ Lese-/Schreibzugriff auf Repositories
    • ✅ Lesen Sie Ihr Benutzerprofil
    • ✅ Zugriff auf private Repositories

  4. Klicken Sie auf “TeamDay autorisieren”

Schritt 3: Verbindung bestätigen

Nach der Autorisierung:

  • Sie werden zurück zu TeamDay weitergeleitet
  • Status zeigt “GitHub verbunden” mit grünem Häkchen
  • Ihr GitHub-Benutzername wird angezeigt
  • Sie können nun private Repositories klonen

Berechtigungen erteilt:

BerechtigungZweck
repoLese-/Schreibzugriff auf Repositories
read:userLesen Sie Ihr GitHub-Profil
missionGitHub Actions auslösen (optional)

GitHub-Verbindung verwalten

Verbindungsstatus anzeigen:

Einstellungen → Integrationen → GitHub

Zeigt:

  • Verbundener Benutzername
  • Letztes Authentifizierungsdatum
  • Token-Ablauf (90 Tage)
  • Gewährte Scopes

GitHub trennen:

  1. Einstellungen → Integrationen → GitHub
  2. Klicken Sie auf “Trennen”
  3. Bestätigen Sie die Trennung

GitHub erneut verbinden:

Wenn Ihr Token abläuft (nach 90 Tagen):

  1. Sie sehen eine “GitHub getrennt” Warnung
  2. Klicken Sie auf “Erneut verbinden”
  3. Autorisieren Sie erneut auf GitHub

Token-Aktualisierung

GitHub-Tokens werden automatisch aktualisiert:

  • Zugriffstoken: 15 Minuten
  • Refresh-Token: 90 Tage

TeamDay handhabt dies automatisch. Sie müssen sich nur erneut autorisieren, wenn das Refresh-Token abläuft.

Repositories klonen

Öffentliches Repository klonen

Über UI:

  1. Öffnen Sie Ihren Space → Dateienpanel
  2. Klicken Sie auf die Schaltfläche ”+” in der Werkzeugleiste
  3. Wählen Sie “Repository klonen”
  4. Geben Sie die Repository-URL ein: 
    https://github.com/username/public-repo.git
  5. (Optional) Geben Sie den Branch an (Standard: main)
  6. (Optional) Geben Sie das Zielverzeichnis an
  7. Klicken Sie auf “Klonen”

Über Agent:

Bitten Sie Ihren Agent, zu klonen:

Benutzer: "Klone das Repository https://github.com/user/repo.git"

Agent: [Führt git clone Befehl aus]

Privates Repository klonen

Voraussetzungen:

Über UI:

  1. Öffnen Sie Space → Dateienpanel

  2. Klicken Sie auf ”+” → “Repository klonen”

  3. Geben Sie die private Repository-URL ein:

    https://github.com/username/private-repo.git

  4. Falls GitHub nicht verbunden:

    • Sie sehen Eingabeaufforderung: “Verbinde GitHub, um private Repositories zu klonen”
    • Klicken Sie auf “GitHub verbinden”
    • Schließen Sie den OAuth-Flow ab
    • Kehren Sie zum Clone-Dialog zurück

  5. Falls GitHub verbunden:

    • Grünes Häkchen zeigt “GitHub verbunden”
    • Klicken Sie auf “Klonen”

Best Practices

1. Früh und oft committen

Tun Sie:

✅ Kleine, fokussierte Commits
✅ Nach jeder logischen Änderung committen
✅ Einfach zu überprüfen und rückgängig zu machen

Beispiel-Mission:

Commit 1: User-Modell hinzufügen
Commit 2: User-Validierung hinzufügen
Commit 3: User-API-Endpunkte hinzufügen
Commit 4: User-Tests hinzufügen

Vermeiden Sie:

❌ Ein riesiger Commit am Ende des Tages
❌ Unzusammenhängende Änderungen mischen
❌ Kaputten Code committen

2. Aussagekräftige Commit-Nachrichten schreiben

Gut:

feat: Fügen Sie JWT-Authentifizierung zur User-API hinzu

- Token-Generierung bei Login implementieren
- Middleware zur Token-Verifizierung hinzufügen
- Refresh-Token-Logik einschließen
- Tests für Auth-Flow hinzufügen

Schlecht:

updates
fix stuff
work in progress

3. Vor dem Push pullen

Synchronisieren Sie sich immer vor dem Pushen:

Benutzer: "Pullen Sie die neuesten Änderungen, dann pushen Sie meine Commits"

Agent: [Führt aus:
  git pull origin main
  git push origin main
]

Verhindert Merge-Konflikte und hält die Historie sauber.

4. Branches für Features verwenden

Erstellen Sie Feature-Branches:

main (stabil)
  ├── feature/add-auth (neue Funktion)
  ├── feature/user-profile (weitere Funktion)
  └── hotfix/login-bug (dringender Fix)

5. Main Branch stabil halten

Main-Branch-Regeln:

  • ✅ Immer bereitstellbar
  • ✅ Alle Tests bestehen
  • ✅ Code überprüft
  • ✅ Keine WIP-Commits

Nächste Schritte

Nachdem Sie die Git-Integration eingerichtet haben:

1. Installieren Sie MCP Plugins

  • Fügen Sie Tools hinzu, um die Agent-Fähigkeiten zu erweitern
  • Leitfaden: MCP Plugins

2. Richten Sie Automatisierung ein

3. Erstellen Sie Missionen

  • Bauen Sie CI/CD-Pipelines
  • Leitfaden: Missionen

4. Erweiterte Git-Nutzung

  • Erfahren Sie mehr über Rebasing, Cherry-Picking und mehr
  • Leitfaden: [Erweitertes Git

Lernressourcen

  • GitHub OAuth - Authentifizierungs-Referenz
  • [Spaces API - Space-Verwaltung
  • [Dateioperationen - Erweiterte Dateiverwaltung
  • [Sicherheit - Sichern Sie Ihre Missionen

Viel Erfolg mit Versionskontrolle! 🚀