Durchsuche GitHub-Dateien aus ClickUp, synchronisiere GitHub-Aktivitäten mit ClickUp-Aufgaben, erstelle GitHub-Pull-Requests, Branches und Issues aus ClickUp und vieles mehr.

Beim Einrichten der Integration verknüpfst du Spaces direkt mit GitHub-Repositories – so siehst du immer, welche Arbeit zusammengehört.

Workspace-Eigentümer und -Admins können Spaces mit ihren Repos verbinden und es Mitgliedern so ermöglichen, ihre GitHub-Arbeit zu Aufgaben hinzuzufügen.

Aufgaben in Spaces mit einem verbundenen Repo lassen sich mit Commits, Branches und Pull Requests verknüpfen.

Was du benötigst

• Die GitHub-Integration ist für jeden ClickUp-Plan verfügbar.
• Nur Repository-Admins können GitHub-Repositories zu ClickUp hinzufügen. Sobald sie hinzugefügt wurden, können Workspace-Admins diese Repositories zu ClickUp-Spaces hinzufügen!
• Nur Workspace-Eigentümer und -Admins können die Workspace-Einstellungen im App Center aktualisieren.
• Nur Workspace-Eigentümer und -Admins können Repositories zu Spaces hinzufügen und mit diesen verknüpfen.
• Nur Workspace-Eigentümer und -Admins können Workspace-Verbindungen erstellen. Mehrere Workspace-Verbindungen sind möglich.
• Mitglieder und höhere Rollen können persönliche Verbindungen erstellen.
• Gäste und eingeschränkte Mitglieder können die GitHub-Integration nicht nutzen.

Verbindungstypen

Die verfügbaren Funktionen und Befehle hängen davon ab, welchen Verbindungstyp du verwendest.

Persönliche Verbindung einrichten

So richtest du eine persönliche Verbindung mit GitHub ein:

1. Klicke oben links auf deinen Workspace-Avatar und wähle Apps aus.
2. Suche nach GitHub und wähle es aus.
3. Klicke auf Verbinden.
4. Folge den Anweisungen, um ClickUp zu autorisieren, und klicke dann auf Fertig.

Workspace-Verbindung einrichten

Eine Workspace-Verbindung für GitHub in ClickUp einzurichten umfasst drei Schritte:

1. GitHub verbinden.
2. GitHub-Repositories an deinen Workspace anhängen. Repositories werden benötigt, damit ClickUp Pull Requests automatisch mit den jeweiligen ClickUp-Aufgaben verknüpfen kann.
3. GitHub-Repositories mit ClickUp Spaces verknüpfen.

Schritt 1: GitHub verbinden

So richtest du eine Workspace-Verbindung für GitHub ein:

1. Klicke oben links auf deinen Workspace-Avatar und wähle Apps aus.
2. Suche nach GitHub und wähle es aus.
3. Klicke oben auf den Tab Workspace.
   • Optional: Deaktiviere die Workspace Connected Search, indem du auf den Schalter daneben klickst.
4. Klicke auf Verbinden.
5. Folge den Anweisungen, um ClickUp zu autorisieren.
6. Lege fest, welche Repositories über die Workspace Connected Search durchsuchbar sein sollen, indem du auf das Dropdownmenü Repositories auswählen klickst.
7. Sobald du Repositories hinzugefügt hast, klicke auf Speichern.

   

8. Klicke auf Weiter und wähle dann Fertig aus.

Schritt 2: GitHub-Repositories zu deinem Workspace hinzufügen

Nur der Eigentümer der Verbindung kann Repositories hinzufügen.

Das Anhängen eines Repositories gibt ClickUp-Nutzern keinen Zugriff auf die Codebasis deines Repositories.

So fügst du ein Repository zu deinem Workspace hinzu:

1. Klicke auf der GitHub-Seite im App Center oben rechts auf Einstellungen.
2. Klicke auf Repository hinzufügen.
3. Wähle ein Repository aus.
4. Um weitere Repositories hinzuzufügen, wiederhole die Schritte 2 und 3.

Wenn du die richtigen Repositories nicht siehst, prüfe, ob du beim richtigen Konto angemeldet bist. Ein Workspace-Eigentümer oder Administrator muss jedes Repository einzeln auswählen, um es zu verbinden. Verknüpfte Repositories lassen sich im App Center einsehen.

Schritt 3: GitHub-Repositories mit ClickUp Spaces verknüpfen

Nachdem du Repositories zu deinem Workspace hinzugefügt hast, können Administratoren jedes Repository mit einem oder mehreren Spaces verbinden. Einem Space können dabei mehrere Repositories hinzugefügt werden.

So verknüpfst du ein Repository mit einem Space:

1. Klicke auf der GitHub-Seite im App Center oben rechts auf Einstellungen.
2. Klicke auf den Namen des Repositories, das du verknüpfen möchtest.
3. Klicke auf + Space hinzufügen.

   

4. Suche nach einem Space und wähle ihn aus.
5. Um weitere Spaces zu verknüpfen, wiederhole die Schritte 2–4.

Format deines Branch-Namens ändern

Wenn deine Organisation ein bestimmtes Format für Branch-Namen verwendet, kannst du es auf der GitHub-Seite im App Center festlegen. Wenn Personen Branches aus ClickUp-Aufgaben erstellen, wird dieses Format genutzt.

Das Standardformat lautet: :taskId:_:taskName:_:username:

Zum Beispiel: CU-ae27de_Auto-generated-naming_John-smith

Die verfügbaren Werte sind in der folgenden Tabelle aufgeführt:

So änderst du das Format deines Branch-Namens:

1. Klicke auf der GitHub-Seite im App Center oben rechts auf Einstellungen.
2. Gib unter Automatisch generierter Branch-Name dein bevorzugtes Branch-Namensformat ein.
3. Klicke auf Speichern.

GitHub-Dateien per Connected Search durchsuchen

Verwende die Workspace Connected Search, damit alle Workspace-Mitglieder beliebige öffentliche Dateien aus den von dir hinzugefügten Repositories durchsuchen können.

Durchsuchbare Repositories bearbeiten

So legst du fest, welche Repositories über die Workspace Connected Search durchsucht werden können:

1. Klicke auf der GitHub-Seite im App Center auf den Tab Workspace.
2. Füge Repositories zur Workspace Connected Search hinzu oder entferne sie daraus:
   • Neue Repositories hinzufügen: Klicke auf das Dropdownmenü Ausgewählte Repositories und wähle ein Repository aus.
   • Ein vorhandenes Repository entfernen: Klicke rechts neben dem Repository auf das Symbol x.

Super Agents die Suche in GitHub ermöglichen

Damit ein Super Agent Dateien in deinem verbundenen GitHub-Konto durchsuchen kann, aktiviere die externe Suche für GitHub in seinem Profil.

Aufgaben aus GitHub verknüpfen

ClickUp verknüpft neue GitHub-Aktivitäten automatisch mit Aufgaben, wenn du eine gültige ClickUp-Aufgaben-ID im Titel oder in der Beschreibung eines Pull Requests, im Branch-Namen oder in der Commit-Nachricht angibst.

Wenn eine ClickUp-Aufgaben-ID in einem Pull Request enthalten ist, wird dort ein Kommentar mit einem Link zur ClickUp-Aufgabe gepostet. Wenn du einen Pull Request manuell in eine ClickUp-Aufgabe einfügst, wird kein Link angezeigt.

Der Kommentar wird über das GitHub-Konto der Person gepostet, die das Repo und das Space-Mapping eingerichtet hat.

Die Aufgaben-ID muss in einem der folgenden Formate angegeben werden:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Aufgaben aus ClickUp verknüpfen

Verknüpfe ClickUp-Aufgaben manuell mit GitHub-Commits, Branches und Pull Requests aus der Aufgabe heraus. Stelle sicher, dass sich die Aufgabe in einem Space befindet, der mit einem Repo verknüpft ist.

So verknüpfst du eine Aufgabe:

1. Öffne eine Aufgabe und klicke auf das GitHub-Symbol.

   

2. Klicke unten rechts auf GitHub-Link hinzufügen.
3. Füge einen Link ein.
4. Klicke unten rechts auf Hinzufügen.

Aktivitäten in ClickUp-Aufgaben

GitHub-Aktivitäten findest du im Aktivitäts-Feed der verknüpften ClickUp-Aufgabe.

Aktivitäts-Feeds von Aufgaben fassen ähnliche Einträge manchmal zusammen, damit du die wichtigsten Details im Blick behältst.

Du hast folgende Möglichkeiten, um GitHub-Aktivitäten in einer Aufgabe zu finden:

• Klicke auf Mehr anzeigen, um ausgeblendete Aktivitäten einzublenden.

  

• Wenn ein Branch gemergt wird, erscheinen die Commits als einzelner Eintrag im Aktivitäts-Feed der Aufgabe.
  • Klicke auf den Link zu allen Commits, um ein Modal zu öffnen.
  • Klicke auf einen einzelnen Commit, um ihn in GitHub zu öffnen.
• Filtere Aufgabenaktivitäten nach Git-Elementen.

  

Fehlende Aktivitäten

Wenn du bestimmte Aktivitäten nicht findest, prüfe, ob du die ClickUp-Aufgaben-ID richtig angibst, um Aktivitäten in GitHub zu verknüpfen. Du kannst eine der folgenden drei Optionen verwenden, um deine ClickUp-Aufgaben in Commits, Branch-Namen und Pull Requests zu referenzieren:

#{task_id}

CU-{task_id}

{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

prefix-1

Außerdem kannst du ClickUp-Aufgaben direkt aus der ClickUp-Aufgabe heraus manuell verknüpfen – mit GitHub-Commits, Branches und Pull Requests.

GitHub-Link-Vorschauen

Wenn du einen GitHub-Link mitten in einem Satz oder in vorhandenem Text einfügst, wird eine Inline-Link-Vorschau angezeigt, über die du weitere Details abrufen kannst.

Wenn du einen GitHub-Link in einer neuen Zeile einfügst, kannst du wählen, ob er als Inline-Link, als Live-Vorschau oder als normale URL angezeigt werden soll.

Link-Vorschauen funktionieren in Aufgabenbeschreibungen, Kommentaren, Dokumente und Chat-Nachrichten. Um den Typ einer Link-Vorschau manuell zu ändern, fahre mit der Maus darüber und klicke auf das Ellipsis …-Symbol.

GitHub-Issues, Branches und Pull Requests aus ClickUp erstellen

Erstelle neue Issues, Branches und Pull Requests direkt aus Aufgaben heraus.

Stelle sicher, dass die Aufgabe sich in einem Space befindet, der mit einem Repo verknüpft ist, und dass du eine persönliche Verbindung eingerichtet hast.

So erstellst du ein Issue, einen Branch oder einen Pull Request:

1. Öffne eine Aufgabe und klicke auf das GitHub-Symbol. Rechts siehst du vorgeschlagene Branch-Namen und Commit-Nachrichten, die du in die Zwischenablage kopieren kannst. Von dort kannst du auch die Aufgaben-ID kopieren.
2. Klicke in der unteren rechten Ecke auf GitHub-Link hinzufügen.
3. Wähle eine der folgenden Optionen:
   • Neues GitHub-Issue
   • Neuer GitHub-Branch
   • Neuer GitHub-Pull-Request
4. Gib dem Issue, dem Branch oder dem Pull Request einen Namen.
5. Wähle ein Repository aus und fülle die Informationen aus. Füge bei Bedarf einen Quell-Branch und einen Ziel-Branch hinzu.

   

6. Klicke auf Erstellen.

GitHub-Panel in Aufgaben

Aufgaben in Spaces, die mit Repos verknüpft sind, haben ein GitHub-Symbol. Klicke darauf, um alle GitHub-Links zu sehen, die in der Aufgabe gepostet wurden.

GitHub-Aufgabenaktivitäten werden mit dem ClickUp-Benutzernamen der Person angezeigt – oder mit deren GitHub-Benutzernamen, wenn sie kein ClickUp-Konto haben.

Aufgaben-Status aus GitHub aktualisieren

Du kannst den Status einer ClickUp-Aufgabe aktualisieren, wenn du einen Commit verlinkst, einen Commit pushst oder einen Pull Request erstellst. ClickUp erkennt neue GitHub-Aktivitäten automatisch und verknüpft sie mit Aufgaben, sofern du eine gültige Aufgaben-ID im Pull-Request-Titel, in der Pull-Request-Beschreibung, im Branch-Namen oder in der Commit-Nachricht angibst.

Die Aufgaben-ID muss in einem der folgenden Formate angegeben werden:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

So aktualisierst du einen Aufgaben-Status:

1. Füge die Aufgaben-ID von ClickUp an einer beliebigen Stelle in der Commit- oder Pull-Request-Nachricht ein.
2. Gib den aktualisierten Aufgaben-Status in eckigen Klammern an.

Beispiel: #ud5b[ready]

Du kannst alle Formate verwenden, die im Abschnitt „Aufgaben aus GitHub verknüpfen" dieses Artikels aufgeführt sind. Achte darauf, kein Leerzeichen zwischen die Aufgaben-ID und die Statusinformation zu setzen, damit die Formatierung korrekt ist.

Du kannst Aufgaben-Status auch über GitHub-Automatisierungen aktualisieren!

GitHub-Issues, Branches, Pull Requests und Commits aus ClickUp verwalten

Nachdem du Issues, Branches, Pull Requests oder Commits verknüpft hast, werden sie angezeigt, wenn du auf das GitHub-Symbol in einer Aufgabe klickst. Über das Menü Ellipsis ... kannst du den Link kopieren oder das Element löschen.

Sobald du ein GitHub-Element verknüpft hast, werden die folgenden Informationen in deiner ClickUp-Aufgabe angezeigt:

Issue-Informationen

Nachdem ein Issue verknüpft wurde, siehst du folgende Details:

• Die Person, die das Issue geöffnet hat (Autor)
• Alle zugewiesenen Reviewer
• Link erstellt
• Repository
• Der Issue-Status
• URL

Branch-Informationen

Nachdem ein Branch verknüpft wurde, siehst du folgende Details:

• Die Person, die den Branch erstellt hat (Autor)
• Link-Ersteller
• Repository
• URL

Pull-Request-Informationen

Nachdem ein Pull Request verknüpft wurde, siehst du folgende Details:

• Die Person, die den Pull Request geöffnet hat (Autor)
• Alle zugewiesenen Reviewer
• Zugewiesene Personen
• Zeilenänderungen
• Link erstellt
• Repository
• Quell-Branch
• Ziel-Branch
• Der Pull-Request-Status
• URL

Commit-Informationen

Nachdem ein Commit verknüpft wurde, siehst du folgende Details:

• Die Person, die den Commit erstellt hat (Autor)
• Geänderte Dateien
• Zeilenänderungen
• Link erstellt
• Repository
• URL

Pull Requests in der Listenansicht oder Tabellenansicht anzeigen

Füge die Spalte „Pull Requests" hinzu, um deine GitHub-Pull-Requests in einer beliebigen Listenansicht oder Tabellenansicht schnell im Überblick zu sehen.

Verbindungsprobleme

Manchmal ist das falsche GitHub-Konto verknüpft oder es liegt ein Problem mit der Verbindung vor. In diesem Fall kannst du versuchen, deine Repositories oder dein gesamtes Konto zu trennen und neu zu verbinden.

Diese Aktionen haben keinen Einfluss darauf, ob andere Personen über ihr GitHub-Konto auf Repositories zugreifen können.

So trennst du ein Repository:

1. Wähle im App Center GitHub aus.
2. Klicke oben rechts auf Settings.
3. Klicke rechts neben dem Repository auf das Ellipsis ...-Symbol.
4. Klicke auf Delete from ClickUp.

GitHub von ClickUp trennen

Wenn du nicht mehr auf GitHub-Dateien in ClickUp zugreifen musst, kannst du die Integration trennen:

1. Wähle im App Center GitHub aus.
2. Wähle den Tab Workspace aus. Nur Eigentümer und Admins können Workspace-Verbindungen trennen.
3. Klicke neben Connected auf das Menü Ellipsis ....
4. Wähle Disconnect aus.
5. Klicke zur Bestätigung auf Disconnect.

OAuth-Scopes

Nachfolgend findest du eine Tabelle aller OAuth-Scopes für die GitHub-Integration, damit du vor der Aktivierung in deinem Workspace fundierte Sicherheits- und Compliance-Entscheidungen treffen kannst.