GitTree Desktop-Handbuch

Nutzen Sie GitTree für Ihre tägliche Arbeit

GitTree ist ein Desktop-Git-Client für macOS, Windows und Linux. Melden Sie sich an und alle lokalen Git-Aufgaben sind im Free-Plan enthalten: Öffnen, Klonen, Festschreiben, Verzweigen, Zusammenführen, Rebasieren, Stashen und Rückgängigmachen. GitTree Pro fügt Hosting-Integrationen, CI/CD-Ausführungen, KI-Entwurf und Nour, den KI-Assistenten, hinzu.

Installieren Sie GitTree auf macOS

GitTree für Mac ist eine universelle App für Apple-Silicon- und Intel-Macs auf macOS 13 oder höher, unterzeichnet und notariell beglaubigt von Apple. Installieren Sie zuerst Git, öffnen Sie die .dmg-Datei, ziehen Sie GitTree auf „Anwendungen“ und starten Sie es.

Installieren Sie GitTree auf Windows

GitTree für Windows ist ein 64-Bit-Installationsprogramm für Windows 10 (22H2) und Windows 11. Installieren Sie zuerst Git for Windows, wählen Sie Microsoft Store oder die direkte EXE-Datei und starten Sie GitTree aus dem Startmenü.

Installieren Sie GitTree auf Linux

GitTree für Linux gibt es als .deb für Ubuntu 22.04 oder höher und Debian 12 oder höher sowie als portables AppImage, beide für 64-Bit x86_64. Installieren Sie zuerst Git 2.39 oder neuer, installieren Sie dann die .deb-Datei mit apt oder führen Sie AppImage aus.

Suchen Sie Git und legen Sie Ihre Commit-Identität fest

GitTree führt das auf Ihrem Computer installierte Git aus und bündelt niemals eines. Es benötigt Git 2.39 oder neuer sowie einen Namen und eine E-Mail-Adresse für Ihre Commits (user.name und user.email), nach denen es fragt, wenn ein Commit sie zum ersten Mal benötigt.

Finden Sie sich zurecht GitTree

Eine Repository-Registerkarte besteht aus sechs Teilen: der Registerkartenleiste, der Symbolleiste, der Seitenleiste, dem Commit-Diagramm, dem Inspektor und der Statusleiste. Diese Seite zeigt, wo sich jeder befindet und was Sie dort tun.

Erstellen Sie Ihr erstes Commit

Ein Commit speichert eine Momentaufnahme der von Ihnen vorgenommenen Änderungen mit einer Meldung, die den Grund dafür angibt. In GitTree stellen Sie eine Datei im Änderungsfeld bereit, geben eine Zusammenfassung ein und drücken Commit: Der neue Commit wird oben im Diagramm angezeigt.

Verwenden Sie lokales Git kostenlos und verstehen Sie Pro

Jede lokale Git-Funktion in GitTree ist für jeden kostenlos, der sich mit einem GitTree-Konto anmeldet. GitTree Pro fügt Nour hinzu, die Hosting-Integrationen und KI-Entwurf; Sie können sie mit einer kostenlosen Testversion ausprobieren, die erst startet, wenn Sie danach fragen.

Öffnen Sie ein vorhandenes Repository

Wählen Sie den Ordner eines Git-Repositorys aus, das sich bereits auf Ihrem Computer befindet, und GitTree öffnet es in einem eigenen Tab mit Commit-Diagramm, Verzweigungen und Änderungen. Es wird nichts hochgeladen: Das Repository verbleibt auf Ihrem Computer.

Klonen Sie ein Repository

Durch das Klonen wird ein Repository von GitHub, GitLab, Bitbucket, Azure DevOps oder einem beliebigen Git-Server mit seinem Verlauf auf Ihren Computer kopiert. In GitTree fügen Sie die URL ein, wählen den Zielort aus und drücken Clone; Wenn es fertig ist, wird es in einem neuen Tab geöffnet.

Erstellen Sie ein Repository

Durch die Initialisierung wird ein Ordner in ein Git-Repository umgewandelt, genau wie git init. In GitTree wählen Sie den Ordner und den ersten Zweig aus, fügen optional ein .gitignore und eine Lizenz hinzu und drücken Initialize.

Verwenden Sie aktuelle und bevorzugte Repositorys

Auf der neuen Registerkarte werden die Repositorys aufgelistet, die Sie unter Recent geöffnet haben, und diejenigen, die Sie unter Favourites markiert haben. Wählen Sie eines aus, um es in einem Tab zu öffnen. Die Listen bleiben auf diesem Computer.

Finden Sie Repositorys auf der Festplatte

Scan for Repositories… durchsucht einen von Ihnen ausgewählten Ordner und listet jedes Git-Repository bis zu drei Ordner tief auf. Es wird nichts geöffnet, bis Sie es auswählen; Sie können eine öffnen oder sie einem Arbeitsbereich hinzufügen.

Überprüfen Sie die Vertrauenswürdigkeit des Repositorys

Einige Repositorys enthalten Git-Einstellungen oder Hooks, die Programme auf Ihrem Computer ausführen, wenn Git darin arbeitet. Bevor das passieren kann, zeigt GitTree Trust this repository? mit genau dem an, was es gefunden hat, und ermöglicht Ihnen, ihm zu vertrauen oder es in Restricted mode zu öffnen.

Öffnen Sie ein leeres Repository

Ein bloßes Repository hat einen Verlauf, aber keine Arbeitsdateien, wie sie Server für andere zum Pushen an (git init --bare, git clone --bare) aufbewahren. GitTree öffnet es, um das Diagramm, die Zweige und Tags anzuzeigen, markiert die Registerkarte bare und deaktiviert Aktionen, die Arbeitsdateien erfordern.

Repository-Registerkarten verwalten

Jedes Repository wird in einer eigenen Registerkarte oben im Fenster geöffnet. Auf Registerkarten wird der Status des Repositorys angezeigt, z. B. nicht festgeschriebene Änderungen oder ein laufender Rebase, und Sie können über die Tastatur zwischen ihnen wechseln.

Lesen Sie das Commit-Diagramm

Das Commit-Diagramm zeigt den Verlauf des Repositorys als Zeilen an, die neuesten zuerst, mit Spuren, die sich dort teilen, wo Zweige beginnen, und sich dort vereinen, wo sie zusammengeführt werden. Beschriftungen in den Zeilen zeigen Zweige und Tags; Ein Häkchen zeigt den Zweig an, in dem Sie sich befinden.

Finden Sie ein Commit

Drücken Sie Strg+F (⌘F auf einem Mac) im Diagramm und geben Sie einen Teil einer Commit-Nachricht, einen Autor, einen SHA, einen Zweig oder ein Tag ein. GitTree hebt die Übereinstimmungen hervor und bewegt sich zwischen ihnen; Filter Graph schränkt den Verlauf selbst ein.

Untersuchen Sie einen Commit

Wählen Sie in der Grafik einen Commit aus und der Inspektor auf der rechten Seite zeigt alles darüber an: die Nachricht, den vollständigen SHA, seine Eltern, wer ihn geschrieben und festgeschrieben hat, und die Dateien, die er geändert hat. Wählen Sie eine Datei aus, um deren Unterschiede anzuzeigen.

Fokussieren und filtern Sie das Diagramm

In einem ausgelasteten Repository zeigt Focus on Current Branch nur Ihren Zweig, seinen Upstream und seine Basis sowie die Anzahl der Commits, die er seit der Basis hat. Filter Graph… behält die Commits eines Autors, eines Datumsbereichs oder eines Pfads bei. Beim Filtern wird der Verlauf niemals gelöscht. Clear Graph Filter bringt jede Zeile zurück.

Diagrammspalten anpassen

Das Diagramm zeigt standardmäßig die Filialbezeichnungen, die Fahrspuren und die Nachricht. Das Menü Graph columns fügt die Spalten Author, Date und SHA hinzu und wechselt zu kompakten Zeilen. Sie können die Größe jeder Spalte ändern und die Seitenbereiche ausblenden.

Vergleichen Sie Commits und reagieren Sie auf eine Auswahl

Wählen Sie zwei Commits aus, indem Sie die Strg-Taste (⌘ auf einem Mac) gedrückt halten, und wählen Sie Compare These Two Commits, um alle Dateien anzuzeigen, die sich unterscheiden. Eine Auswahl mehrerer Commits hat ihre eigenen Aktionen: Kopieren der SHAs, Rosinenauswahl, Zurücksetzen, Squash oder Erstellen eines Patches.

Verwenden Sie Drag-and-Drop für Diagramme

Ziehen Sie eine Zweigbezeichnung auf einen anderen Zweig im Diagramm und GitTree bietet an, was die beiden tun können: Fast-forward, Merge oder Rebase. Es passiert nichts, bis Sie sich entscheiden; Es gelten die üblichen Bestätigungs- und Rückgängig-Funktionen.

Überprüfen Sie funktionierende Änderungen

Das Panel Working Changes ist das git status von GitTree: Es listet alle Dateien auf, die Sie seit dem letzten Commit geändert haben, aufgeteilt in Unstaged Files und Staged Files, und zeigt den Unterschied der von Ihnen ausgewählten Datei an.

Bühnendateien, Stücke und ausgewählte Zeilen

Ein Commit enthält nur das, was Sie bereitstellen. In GitTree stellen Sie eine ganze Datei, einen Teil davon oder nur die Zeilen bereit, die Sie im Diff auswählen, und der Rest Ihrer Änderungen bleibt für einen späteren Commit im Arbeitsordner.

Schreiben Sie eine Commit-Nachricht und führen Sie einen Commit durch

Das Commit-Formular befindet sich unter Ihren bereitgestellten Dateien: eine Summary-Zeile, ein optionales Description und Commit Options für Co-Autoren, Abzeichnung, Hooks und anschließendes Pushen. GitTree weist Sie auf häufige Nachrichtenfehler hin, bevor Sie sich verpflichten.

Ändern Sie den letzten Commit

Durch die Änderung wird der letzte Commit durch einen neuen ersetzt, der Ihre korrigierte Nachricht und alle Änderungen enthält, die Sie jetzt vornehmen, z. B. git commit --amend. In GitTree ist es der Schalter Amend Previous Commit im Commit-Formular.

Verwerfen Sie Änderungen und bereinigen Sie nicht verfolgte

Durch das Verwerfen werden Dateien auf ihren letzten festgeschriebenen oder bereitgestellten Status zurückgesetzt, z. B. git restore; Beim Bereinigen werden Dateien entfernt, die Git nicht verfolgt, z. B. git clean. GitTree speichert zuerst einen Wiederherstellungs-Snapshot, damit Undo sie wiederherstellen kann.

Wählen und verwenden Sie eine Diff-Ansicht

Jeder Unterschied in GitTree kann als Hunk, Inline oder Split (nebeneinander) angezeigt werden. Markieren Sie die geänderten Wörter, brechen Sie lange Zeilen um, ignorieren Sie Leerzeichenänderungen, zeigen Sie Markdown in der Vorschau an und springen Sie von einer Änderung zur nächsten.

Dateien von GitTree ignorieren

Dateien, die Sie niemals festschreiben möchten, z. B. Build-Ausgaben oder lokale Einstellungen, gehören in .gitignore. Klicken Sie mit der rechten Maustaste auf eine neue Datei in Ihren Arbeitsänderungen und wählen Sie aus, was ignoriert werden soll, oder bearbeiten Sie .gitignore direkt mit Edit .gitignore….

Erstellen Sie Patches und wenden Sie sie an

Ein Patch ist eine Datei, die Änderungen von einem Repository in ein anderes überträgt. GitTree speichert die Änderungen einer Datei oder einen oder mehrere Commits als Patch und wendet einen Patch auf Ihren Arbeitsbaum an, bereitgestellt oder als Commits im aktuellen Zweig.

Überprüfen Sie Bilder und binäre Änderungen

Textunterschiede können kein Bild anzeigen. Wenn sich ein PNG-, JPEG-, GIF-, WebP- oder anderes Bild ändert, vergleicht GitTree die Vorher- und Nachher-Bilder: Side by side, Swipe oder Onion skin. Andere Binärdateien zeigen ihre Größe an.

Verwalten Sie Indexflags für verfolgte Dateien

Manchmal ändern Sie eine verfolgte Datei nur auf Ihrem Computer, beispielsweise eine lokale Konfiguration. Zwei Git-Flags verbergen solche Änderungen: Skip Worktree… behält Ihre Kopie und zeigt ihre Änderungen nicht mehr an; Assume Unchanged… ist eine Beschleunigung, die Git davon abhält, die Datei zu überprüfen. Es gibt auch keine Möglichkeit, eine Datei zu ignorieren.

Zweige erstellen und wechseln

Eine Niederlassung ist ein beweglicher Name für eine Branche. In GitTree erstellt Branch in der Symbolleiste einen bei dem Commit, an dem Sie sich gerade befinden; Klicken Sie mit der rechten Maustaste auf einen beliebigen Commit, um dort einen zu erstellen. Doppelklicken Sie auf eine Zweigbezeichnung, um zu dieser zu wechseln.

Zweige umbenennen und löschen

Klicken Sie mit der rechten Maustaste auf eine Zweigbezeichnung für Rename und Delete. Durch das Löschen eines lokalen Zweigs wird dessen letztes Commit zuerst unter refs/ogt/trash gespeichert, sodass Undo ihn zurückbringt. Das Löschen auf der Fernbedienung ist eine separate, klar benannte Option.

Erstellen und verwalten Sie Tags

Ein Tag ist ein fester Name für einen Commit, normalerweise eine Veröffentlichung wie v2.2.0. Klicken Sie mit der rechten Maustaste auf ein Commit, wählen Sie Tag Here und dann ein Lightweight-Tag oder ein mit Anmerkungen versehenes Tag. Tags werden nicht mit Ihren Commits gepusht: Pushen Sie jedes einzelne mit Push Tag.

Legen Sie die Nachverfolgung fest und veröffentlichen Sie einen Zweig

Ein neuer Zweig existiert nur auf Ihrem Computer, bis Sie ihn pushen. Das erste Push fragt, an welche Gegenstelle es gesendet werden soll, und von da an verfolgt der Zweig diesen Fernzweig (seinen Upstream), wie git push -u. Set Upstream… ändert, was es verfolgt.

Vergleichen Sie Zweige und Tags

Compare References… vergleicht zwei beliebige Branches, Tags, Remote-Branches oder Commits nach Namen. Es zeigt, wie viele Commits eins vor und hinter dem anderen liegt, und die Dateien, die sich unterscheiden: entweder jeder Unterschied (git diff A B) oder nur das, was die neue Seite seit der Trennung geändert hat (A...B, was ein Pull-Request zeigt).

Verwenden Sie Gitflow-Aktionen

Gitflow ist ein Verzweigungsmodell mit einem Produktionszweig, einem Entwicklungszweig sowie Feature-, Release- und Hotfix-Zweigen. Der Abschnitt Gitflow von GitTree initialisiert es und startet und beendet diese Zweige, indem er sie für Sie zusammenführt, markiert und löscht.

Den KOPF erkennen und loslassen

Das Auschecken eines Commits oder eines Tags anstelle eines Zweigs führt Sie zu einem detached HEAD: Sie befinden sich in keinem Zweig. Sie können sich umschauen und sogar einen Commit durchführen, aber neue Commits gehören zu keinem Branch. Erstellen Sie einen Zweig, um sie zu behalten, oder checken Sie einen Zweig aus, um zurückzukehren.

Holen, ziehen und schieben

Fetch lädt die Neuerungen auf Ihre Fernbedienungen herunter, ohne Ihre Arbeit zu ändern. Pull bringt den Upstream Ihrer Zweigstelle hinein. Push sendet Ihre Commits an die Fernbedienung. Alle drei befinden sich in der Symbolleiste, mit ihren Optionen in den Pfeilmenüs daneben.

Fernbedienungen hinzufügen und bearbeiten

Ein Remote ist eine benannte Kopie des Repositorys an anderer Stelle, z. B. origin auf GitHub. Im Abschnitt Remote des linken Bereichs werden sie aufgeführt. Add Remote… fügt einen hinzu, und wenn Sie mit der rechten Maustaste auf einen Remote-Zugriff klicken, wird dieser bearbeitet, abgerufen, bereinigt oder entfernt.

Wählen Sie Remote-Anmeldeinformationen

GitTree führt Ihr eigenes Git aus, also holen, ziehen und pushen Sie die Anmeldung auf die gleiche Weise wie Git auf Ihrem Computer: über HTTPS über Ihren Credential Helper, über SSH mit Ihrem Schlüssel oder SSH-Agenten. Passwörter und Token bleiben in Ihrem Systemschlüsselbund, niemals in den Dateien von GitTree.

Konfigurieren Sie den automatischen Abruf

Durch den automatischen Abruf bleiben die entfernten Zweige in Ihrem Diagramm aktuell, ohne dass Sie Fetch All drücken müssen. Legen Sie die Auto-fetch interval in Minuten für jedes geöffnete Repository fest, überschreiben Sie sie für ein Repository und erhalten Sie eine Desktop-Benachrichtigung, wenn neue Commits eintreffen.

Verwenden Sie einen Force-Push mit Lease

Nachdem Sie Commits, die Sie bereits gepusht haben, ändern, neu festlegen oder zurücksetzen, wird ein normaler Push abgelehnt. Force Push (With Lease)… ersetzt den Remote-Zweig durch Ihren, aber nur, wenn er sich immer noch dort befindet, wo Sie ihn zuletzt abgerufen haben, wie git push --force-with-lease. GitTree drückt niemals auf andere Weise mit Gewalt.

Arbeiten Sie mit begrenztem Repository-Verlauf

Ein flacher Klon lädt nur die neuesten Commits herunter; Ein Blobless-Klon lädt Dateiinhalte nur bei Bedarf herunter. Beide ermöglichen das schnelle Klonen großer Repositories. In einem flachen Klon zeigt das Diagramm, wo der Verlauf aufhört, und Fetch More History oder Fetch Full History bringen den Rest.

Zweige zusammenführen

Durch das Zusammenführen werden die Commits eines anderen Zweigs in den Zweig übertragen, in dem Sie sich befinden, z. B. git merge. Klicken Sie mit der rechten Maustaste auf den anderen Zweig und wählen Sie Merge … into …: GitTree prüft zuerst auf Konflikte und lässt Sie auswählen, wie die Zusammenführung aufgezeichnet wird.

Rebasieren Sie einen Zweig

Beim Rebasing werden die Commits Ihres Zweigs über einem anderen Zweig wiederholt, sodass der Verlauf eine gerade Linie bleibt, wie git rebase. Die Commits erhalten neue IDs; GitTree behält den alten Zweig unter refs/ogt/trash und Undo bringt ihn zurück.

Zusammenführungskonflikte lösen

Ein Konflikt entsteht, wenn beide Zweige dieselben Zeilen geändert haben. Der Resolver von GitTree zeigt die beiden Versionen A und B nebeneinander an: Kreuzen Sie die Zeilen an, die in jedem Konflikt beibehalten werden sollen, überprüfen Sie Output, dann Save und fahren Sie mit der Zusammenführung, dem Rebase oder der Rosinenauswahl fort.

Commits auswählen und zurücksetzen

Cherry-Pick Commit kopiert die Änderungen eines Commits als neuen Commit in Ihren aktuellen Zweig, wie git cherry-pick. Revert Commit fügt einen neuen Commit hinzu, der einen rückgängig macht, wie git revert: der sichere Weg, etwas bereits gepushtes zurückzunehmen.

Einen Vorgang fortsetzen, überspringen oder abbrechen

Eine Zusammenführung, ein Rebase, ein Cherry-Pick oder ein Revert kann auf halbem Weg zum Stillstand kommen, normalerweise aufgrund eines Konflikts. Ein Banner über dem Diagramm benennt den Vorgang und seinen Schritt und bietet Resolve, Continue, Skip (Rebase) und Abort…. Durch den Abbruch wird gespeichert, was zuerst gelöscht wird, sodass Undo es zurückbringt.

Aufgezeichnete Konfliktlösungen wiederverwenden

Wenn Reuse recorded resolutions (rerere) aktiviert ist, merkt sich Git, wie Sie einen Konflikt gelöst haben, und schreibt die gleiche Lösung, wenn dieser Konflikt erneut auftritt, beispielsweise während eines wiederholten Rebases. GitTree teilt Ihnen mit, wann es passiert ist, und ermöglicht es Ihnen, es zu überprüfen, bevor Sie die Datei als gelöst markieren.

Bearbeiten Sie den Verlauf mit einer interaktiven Rebase

Bei einem interaktiven Rebase werden die Commits über einem ausgewählten neu geschrieben: Behalten, umformulieren, bearbeiten, komprimieren, korrigieren oder löschen und sie in eine neue Reihenfolge ziehen, z. B. git rebase -i. Bei einer einzelnen Änderung führt Edit History im Menü eines Commits dies in einem Schritt aus.

Squash-Commits

Squashing kombiniert mehrere Commits zu einem, wie ein fixup oder squash in git rebase -i. In GitTree öffnet jeder Squash zuerst den Squash-Dialog: Er zeigt die ausgeführten Commits, das Ergebnis, die Nachricht und wer die Gutschrift erhält, und bis zur Bestätigung ändert sich nichts. Ihre nicht festgeschriebene Arbeit wird nie berührt und Undo setzt die Festschreibungen zurück.

Ausgewählte lokale Commits ändern

Für eine schnelle Änderung des Verlaufs benötigen Sie nicht den gesamten interaktiven Rebase-Editor. Das Edit History-Menü eines Commits bearbeitet seine Nachricht, löscht sie oder verschiebt sie nach oben oder unten; Wenn Sie mehrere Commits auswählen, wird das Dialogfeld Squash geöffnet. GitTree schreibt die darüber liegenden Commits neu und behält den alten Zweig bei, also setzt Undo ihn zurück.

Setzen Sie einen Zweig auf einen Commit zurück

Durch das Zurücksetzen wird Ihr aktueller Zweig zu einem anderen Commit verschoben, z. B. git reset. Soft speichert jede Änderung, Mixed behält sie in Ihrem Arbeitsordner und Hard verwirft sie. GitTree speichert zuerst alles unter refs/ogt/trash, sodass auch ein Hard-Reset rückgängig gemacht werden kann.

Rückgängig machen und wiederholen

GitTree zeichnet Ihre Git-Vorgänge auf, sodass Undo in der Symbolleiste den letzten zurücknehmen kann: einen Commit, eine Zusammenführung, ein Rebase, ein Zurücksetzen, ein Verwerfen, ein Bereinigen, einen gelöschten Zweig oder ein Tag. Redo macht es noch einmal. Zerstörerische Schritte speichern einen Wiederherstellungs-Snapshot unter refs/ogt/trash, bevor sie ausgeführt werden.

Hier finden Sie Tipps zu früheren Branchen

Das Reflog zeichnet bei jeder Verschiebung auf, wohin ein Branch oder HEAD zeigte: Commits, Checkouts, Resets, Rebases. View Reflog… listet diese Einträge auf; Wählen Sie eines aus, um dessen Commit im Diagramm anzuzeigen, oder Restore as Branch.

Dateiverlauf und Schuldzuweisungen

History listet jeden Commit auf, der eine Datei nach Umbenennungen geändert hat, z. B. git log --follow. Blame zeigt für jede Zeile den Commit und den Autor an, der sie zuletzt geändert hat, z. B. git blame. Beides sind Ansichten des Dateiarbeitsbereichs.

Verwenden Sie den Bisect-Workflow

Bisect findet den ersten Commit, der ein Problem verursacht hat, indem es den Verlauf zwischen einem Commit, bei dem es vorhanden ist, und einem Commit, bei dem es nicht vorhanden ist, wie git bisect, halbiert. Wählen Sie die beiden Commits aus, testen Sie den Commit, den GitTree auscheckt, markieren Sie ihn als Good oder Bad und wiederholen Sie den Vorgang, bis er den Namen First bad commit trägt.

Exportieren Sie ein Archiv

Export Archive… schreibt die Dateien eines Commits, Zweigs oder Tags als .zip oder .tar.gz, ohne den Ordner .git, wie git archive. Dies ist der schnellste Weg, jemandem die Quelle einer Veröffentlichung zu geben.

Verwenden Sie Repository-Wartungs- und Autorentools

Repository Maintenance… zeigt die Größe der Objektdatenbank an und führt Aufgaben aus, die sie überprüfen oder den Verlauf und Status beschleunigen. Merge Author Identities… schreibt .mailmap Zeilen, sodass eine Person mit mehreren Namen oder E-Mail-Adressen als ein Autor angezeigt wird.

Arbeitsbereiche organisieren

Ein Arbeitsbereich ist ein benannter Satz von Repositorys, der als Einheit geöffnet wird, z. B. „Client A“ oder „Mobil“. Das Dashboard zeigt den Branch, den Synchronisierungsstatus und die Änderungen jedes Repositorys sowie die Pull-Requests und CI/CD-Ausführungen darüber an.

Gespeicherte Repositorys verwalten

Jeder Arbeitsbereich führt eine Liste von Saved repositories: Jedes Repository, das Sie öffnen, klonen, erstellen oder aus einem Scan hinzufügen, während es der aktuelle Arbeitsbereich ist, wird dort gespeichert und verbleibt, nachdem die Registerkarte geschlossen wird. Öffnen Sie sie alle auf einmal aus der Liste oder entfernen Sie eine; sein Ordner wird nie berührt.

Stash-Änderungen

Ein Stash legt Ihre nicht festgeschriebenen Änderungen beiseite und stellt Ihnen einen sauberen Arbeitsordner wie git stash zur Verfügung, sodass Sie Aufgaben wechseln und die Änderungen später wiederherstellen können. Stash in der Symbolleiste speichert alles; Auf der Registerkarte Stash des Änderungsfelds wird genau ausgewählt, was.

Bearbeiten Sie mehrere Zweige mit Arbeitsbäumen

Ein Arbeitsbaum ist ein zweiter Arbeitsordner für dasselbe Repository mit einem eigenen ausgecheckten Zweig, wie git worktree add. Überprüfen Sie eine Pull-Anfrage, führen Sie einen langen Build aus oder lassen Sie einen Codierungsagenten in einem arbeiten, ohne etwas im anderen zu verstecken.

Submodule verwalten

Ein Submodul ist ein weiteres Repository, das bei einem bestimmten Commit in Ihrem Repository verankert ist. GitTree listet sie mit ihrem Status auf (nicht initialisiert, aktuell, anderes Commit, Konflikt) und fügt sie hinzu, initialisiert, aktualisiert, öffnet, bearbeitet und entfernt.

Verwenden Sie Git LFS-Steuerelemente

Git LFS speichert große Dateien wie Bilder, Videos oder Modelle außerhalb des Repositorys und behält an ihrer Stelle kleine Zeigerdateien. Git LFS… richtet es ein, verfolgt Muster, lädt Inhalte herunter, sperrt Dateien und bereinigt alte Inhalte.

Projektdateien durchsuchen und bearbeiten

Im Abschnitt Files des linken Bereichs werden die Ordner Ihres Projekts angezeigt und diejenigen markiert, die Änderungen enthalten. Öffnen Sie eine Datei, um sie in einer Registerkarte neben der Registerkarte Graph zu lesen oder zu bearbeiten, und wechseln Sie zwischen File, Changes, Blame und History.

Dateien öffnen und bearbeiten

Eine Datei, die Sie in GitTree öffnen, erhält eine eigene Registerkarte neben der angehefteten Registerkarte Graph. Eine Datei aus einem Commit ist schreibgeschützt; Edit in Working Directory öffnet die Kopie in Ihrem Projekt zum Bearbeiten und Save. Wenn sich die Datei in der Zwischenzeit auf der Festplatte ändert, speichert GitTree nichts und überlässt Ihnen die Auswahl.

Kehren Sie zum Commit-Diagramm zurück

Unterschiede, Dateien, Schuldzuweisungen, Verlauf, Vergleiche, Pipelines und Pull-Anfragen werden über dem Diagramm geöffnet. Esc schließt das obere Fenster und kehrt zu der Ansicht zurück, in der es geöffnet wurde. Back to Graph entfernt sie alle auf einmal. Geöffnete Dateien werden nur ausgeblendet: Ihre Registerkarten bleiben neben der Registerkarte Graph.

Nutzen Sie das integrierte Terminal

Terminal in der Symbolleiste öffnet eine Shell im Stammverzeichnis des Repositorys in der Schublade unter dem Diagramm. Führen Sie dort einen beliebigen Befehl aus, einschließlich Git: Das Diagramm und Ihre Änderungen werden dabei aktualisiert. Jede Repository-Registerkarte verfügt über eigene Terminals.

Externe Tools konfigurieren

Einstellungen › External Tools wählt die Optionen Editor, Diff tool und Merge tool aus. GitTree wird aus den Dateimenüs und der Konfliktansicht geöffnet. Automatic verwendet die erste Installation von Visual Studio Code, Cursor und Antigravity; Custom… führt jedes Programm mit den von Ihnen angegebenen Argumenten aus.

Erstellen Sie benutzerdefinierte Aktionen und führen Sie sie aus

Benutzerdefinierte Befehle führen Ihre eigenen Programme in einem Repository über die Schaltfläche Custom actions und über die Menüs „Commit“, „Branch“ und „File“ aus. Jedes Argument wird genau wie geschrieben übergeben, es ist keine Shell beteiligt, und die erste Ausführung eines Befehls zeigt genau, was davor ausgeführt wird.

Finden Sie Aktionen mit der Befehlspalette

Die Befehlspalette führt jeden GitTree-Befehl aus, indem sie einen Teil seines Namens eingibt, und springt auch zu Zweigen, Commits, Dateien und offenen Repositorys. Drücken Sie Strg+Umschalt+P (⌘⇧P auf einem Mac), geben Sie ein und drücken Sie die Eingabetaste.

Tastaturkürzel

Die meisten GitTree-Befehle verfügen über eine Verknüpfung. Drücken Sie Strg+/ (⌘/ auf einem Mac), um die vollständige Liste in der App anzuzeigen, gefiltert während der Eingabe; Customize… dort ändert sich einer von ihnen. In den folgenden Tabellen sind die Standardeinstellungen aufgeführt.

Überprüfen Sie Aktivitäten und Benachrichtigungen

Das Activity Log listet jeden ausgeführten Git-Befehl GitTree mit seiner Ausgabe auf, wie lange es gedauert hat und ob es fehlgeschlagen ist; Token, Passwörter und Anmeldeinformationen in URLs werden entfernt. Notifications behält die in dieser Sitzung angezeigten Nachrichten bei und Einstellungen › Notifications entscheidet, welches Popup angezeigt wird und ob Ihr System sie auch anzeigt.

Nutzen Sie den In-App-Funktionsleitfaden

Das Feature Guide listet alles auf, was GitTree tun kann, wo es zu finden ist und seine Verknüpfungen, gruppiert nach Bereich, mit einem Suchfeld. Show me führt Sie zu der Funktion im Repository, das Sie geöffnet haben; Funktionen, die ein Repository, Pro oder ein verbundenes Konto benötigen, sagen dies.

Verbinden GitHub

Wenn Sie eine Verbindung zu GitHub herstellen, können GitTree Ihre Repositorys, Pull-Anfragen, Probleme und Prüfungen auflisten. Melden Sie sich mit Ihrem Browser an (empfohlen: Sie genehmigen GitTree auf der eigenen Seite von GitHub) oder verwenden Sie ein persönliches Zugriffstoken. Der Token wird nur im Schlüsselbund Ihres Systems aufbewahrt.

Verbinden GitLab

GitTree stellt eine Verbindung zu gitlab.com oder zu einem von Ihnen benannten selbstverwalteten GitLab-Host her. Melden Sie sich mit dem Browser über eine OAuth-Anwendung an (für gitlab.com wird die eigene von GitTree verwendet) oder verwenden Sie ein persönliches Zugriffstoken von diesem Host. Der Token wird nur für diesen Host verwendet.

Verbinden Sie die Bitbucket Cloud

GitTree stellt auf drei Arten eine Verbindung zu Bitbucket Cloud (bitbucket.org) her: Melden Sie sich mit Ihrem Bitbucket-Konto im Browser an, verwenden Sie ein Atlassian-API-Token mit der E-Mail-Adresse des Kontos oder verwenden Sie ein Arbeitsbereichs-, Projekt- oder Repository-Zugriffstoken. Token werden nur im Schlüsselbund Ihres Systems aufbewahrt.

Verbinden Sie das Bitbucket-Rechenzentrum

Benennen Sie für einen Bitbucket Data Center-Server eines Unternehmens dessen Host und verwenden Sie dann ein persönliches HTTP-Zugriffstoken oder melden Sie sich mit dem Browser über den eingehenden OAuth-Anwendungslink an, den Ihr Administrator für GitTree erstellt hat. GitTree kommuniziert nur mit diesem Host.

Verbinden Sie Azure DevOps

Melden Sie sich mit Ihrem Microsoft-Konto im Browser an oder verwenden Sie ein persönliches Zugriffstoken von Azure DevOps. GitTree spricht mit dev.azure.com und dem Profildienst von Microsoft, um Ihre Organisationen zu finden, und listet dann deren Repositorys, Pull-Anfragen und Pipelines auf.

Verbinden Sie Unternehmens- und selbstgehostete Server

GitTree stellt eine Verbindung zu den eigenen Servern Ihres Unternehmens her: GitHub Enterprise Server, selbstverwaltet GitLab und Bitbucket Data Center. Sie nennen den Gastgeber; GitTree kommuniziert nur mit https:// diesem Host und das Token wird nur für diesen Host verwendet. Für die Browseranmeldung ist eine OAuth-Anwendung erforderlich, die Ihr Administrator dort registriert hat.

Überprüfen Sie die Verfügbarkeit der Integration

Nicht alle Anbieter bieten das Gleiche an. Auf der Registerkarte Integrations des Funktionsleitfadens wird für den Anbieter des offenen Repositorys und Ihr Konto angezeigt, was Available ist, was dieser Anbieter ist Not offered by und was Coming soon ist.

Durchsuchen und erstellen Sie Anbieter-Repositorys

Wenn ein Konto verbunden ist, listet Clone a repository die Repositorys dieses Kontos nach Owner mit Suche auf, sodass Sie keine URL kopieren müssen. Publish Repository… geht in die andere Richtung: Es erstellt das Repository in Ihrem Konto, fügt es als Remote hinzu und pusht Ihren Zweig.

Verwenden Sie Forks von GitTree

Ein Fork ist Ihre eigene Kopie eines Repositorys beim Anbieter. Create Fork… fordert den Anbieter auf, einen zu erstellen; Add Remote from Fork… fügt einen vorhandenen Fork als Remote hinzu. Durch das Erstellen eines Forks ändert sich nichts in Ihrem Repository, bis Sie es hinzufügen, und ein vorhandener Remote-Fork wird niemals ersetzt.

Pull-Anfragen

Wenn ein Hosting-Konto verbunden ist, listet GitTree die Pull-Requests des Repositorys im linken Bereich auf und öffnet jeden einzelnen neben dem Diagramm: seine Konversation, Commits, Dateien und Prüfungen, mit Review… und Merge…. Pull-Anfragen sind Teil von GitTree Pro.

Erstellen Sie eine Pull- oder Merge-Anfrage

Klicken Sie mit der rechten Maustaste auf Ihren Zweig und wählen Sie Start a Pull Request…. Wählen Sie aus, was From und Into zusammenführen soll, schreiben Sie Title und Description, fügen Sie Prüfer hinzu, optional Open as a draft, und drücken Sie Create Pull Request. Ein Zweig, der sich noch nicht auf der Fernbedienung befindet, wird zuerst gepusht.

Überprüfen und besprechen Sie Änderungen

Öffnen Sie die Pull-Anfrage, lesen Sie Files und drücken Sie neben einer Zeile auf +, um Ihrer Rezension einen Zeilenkommentar hinzuzufügen. Review… sendet Ihre Entscheidung (Approve, Request changes oder Comment) mit einem Summary und jedem Zeilenkommentar. Gespräche können dort beantwortet und gelöst werden, wo der Anbieter dies unterstützt.

Eine Pull-Anfrage zusammenführen oder schließen

Merge… fragt den Anbieter, wie die Pull-Anfrage zusammengeführt werden kann, zeigt an, ob es sich um Ready to merge handelt, und bietet nur die Merge methods an, die das Repository zulässt. GitTree wird nur zusammengeführt, solange der Kopf noch der Commit ist, den Sie sich angesehen haben; Wenn neue Commits eintreffen, wird nichts zusammengeführt.

Verwenden Sie unterstützte Problemaktionen

Der Abschnitt Issues im linken Bereich listet die offenen Probleme des Repositorys auf. Öffnen Sie eines, um es zu lesen und zu kommentieren, erstellen Sie eines mit New Issue… oder beginnen Sie mit der Arbeit mit Create Branch from Issue…. Auf der Seite des Anbieters treten Probleme beim Schließen und Bearbeiten auf: Open Issue in Browser.

Überprüfen Sie die Schecks und den Commit-Status

GitTree zeigt den CI-Status von Commits und Pull-Anfragen: Checks passing, Checks failing, Checks running, Checks skipped oder No checks reported, mit der Anzahl der bestandenen, fehlgeschlagenen, ausgeführten oder übersprungenen Anfragen. Wählen Sie es aus, um die Läufe anzuzeigen, das Protokoll einer Prüfung zu öffnen oder Re-run Check.

CI/CD läuft

GitTree zeigt die CI/CD-Ausführungen des Hosts Ihres Repositorys, z. B. GitHub-Aktionen, im linken Bereich und in einer vollständigen Liste neben dem Diagramm an: was bestanden wurde, was fehlgeschlagen ist und warum, mit Re-run Failed Jobs, Cancel Run… und Run Workflow…. CI/CD ist Teil von GitTree Pro.

Durchsuchen und filtern Sie Läufe

Die CI/CD-Liste zeigt jede Ausführung des Repositorys und aktualisiert sich während der Ausführung. Filters schränkt es ein durch Branch, Workflow, Status und Trigger; Mine hält deine Läufe; Watch aktualisiert einen Lauf im Hintergrund und teilt Ihnen mit, wann er beendet ist.

Jobs und Protokolle lesen

Öffnen Sie einen Lauf und wählen Sie einen Job oder Schritt aus, um dessen Protokoll auf der Registerkarte Log zu lesen. Jump to first error geht direkt zum Fehler, Search the log… findet Text, Timestamps und Wrap ändern die Ansicht, Following behält die Live-Ausgabe eines laufenden Jobs im Blick und Save Log… schreibt sie in eine Datei.

Führen Sie eine Pipeline erneut aus oder brechen Sie sie ab

Bei einer Ausführung wiederholt Re-run Failed Jobs nur das, was fehlgeschlagen ist, Re-run All Jobs wiederholt alles und das Menü eines Jobs führt nur diesen Job erneut aus (Retry Stage auf Phasen im GitLab-Stil). Cancel Run… stoppt es; Force Cancel Run… beendet es, ohne dass Jobs bereinigt werden. Beide Stornierungen können nicht rückgängig gemacht werden.

Führen Sie einen Workflow aus

Run Workflow… startet einen Workflow, der manuell ausgeführt werden kann, z. B. einen GitHub-Aktionsworkflow mit einem workflow_dispatch-Trigger oder einer Bitbucket-custom-Pipeline. GitTree liest seine Eingaben aus der Workflow-Datei in der von Ihnen gewählten Verzweigung und zeigt für jede ein Feld an.

Laden Sie verfügbare Artefakte herunter

Auf der Registerkarte Artifacts eines Laufs werden die von ihm erzeugten Dateien mit Name, Size und wann Expires aufgeführt. Save… fragt, wo es gespeichert werden soll und lädt es dort herunter, da der Anbieter es speichert; Eine ZIP-Datei wird als ZIP-Datei gespeichert und GitTree öffnet sie nicht.

Überprüfen Sie Bereitstellungen und Umgebungen

Bei einer Ausführung, die eine Bereitstellung durchführt, werden Deploys to … und die Registerkarte Environments angezeigt: jede Umgebung, ihre Bereitstellung, Verzweigung oder Festschreibung und wann. Eine wartende Bereitstellung zeigt Waiting for approval; Wenn Sie einer seiner Prüfer sind, werden Approve Deployment… und Reject Deployment… entsprechend handeln. Diese verändern Dinge für alle und können nicht rückgängig gemacht werden.

Erstellen und überprüfen Sie Pipeline-Dateien

New CI/CD File… schreibt eine Starterdatei dort, wo Ihr Anbieter sie liest, z. B. .github/workflows/ oder .gitlab-ci.yml; Es wird niemals eine vorhandene Datei überschrieben. Bearbeiten Sie es in GitTree, drücken Sie Check with …, damit der Anbieter es validiert, und übergeben Sie es dann wie jede andere Datei.

Pipeline-Einstellungen verwalten

CI/CD Settings zeigt, was der Anbieter einer anderen App verwalten lässt: Variables, Secrets, Environments, Runners, Schedules, Caches, Definitions und Releases. Der Wert eines Geheimnisses wird in eine sichere Systemeingabeaufforderung eingegeben oder aus einer von Ihnen ausgewählten Datei gelesen und geht direkt an den Anbieter; GitTree wird es niemals zeigen, aufbewahren oder irgendwo anders versenden.

Verwenden Sie Pipeline-Release-Kontrollen

CI/CD Settings › Releases listet die Veröffentlichungen des Repositorys auf. New Release benennt ein Tag (oder erstellt eines aus einem Branch oder Commit), mit einem Title, Notes (Markdown) und Dateien, die Benutzer herunterladen können. Eine Veröffentlichung wird für alle veröffentlicht, die das Repository sehen können, es sei denn, Sie Save as a draft.

Fragen Sie Nour nach einem Pipeline-Fehler

Explain Failure öffnet Nour mit einer Frage zu einem fehlgeschlagenen Lauf. Nour liest das Protokoll des fehlgeschlagenen Schritts (höchstens 64 KiB) nur, wenn Sie dies jedes Mal genehmigen, und antwortet mit dem, was seiner Meinung nach schief gelaufen ist und was versucht werden sollte. Betrachten Sie die Antwort als Ratschlag: Vergleichen Sie sie mit dem Protokoll.

Richten Sie Nour ein, den KI-Assistenten

Nour ist der KI-Assistent von GitTree. Es führt die Coding-Agent-CLI aus, die Sie bereits verwenden, z. B. Claude Code, Codex oder Gemini CLI, mit Ihrem eigenen Abonnement: GitTree sieht Ihre Schlüssel nie. Im Ask-Modus schaut Nour nur und antwortet; Im Agent-Modus kann es innerhalb der von Ihnen erlaubten Grenzen agieren. Nour ist Teil von GitTree Pro.

Fragen Sie Nour nach Ihrer Arbeit

Nour kennt immer das Repository und den ausgecheckten Zweig des Chats. Geben Sie @ ein, um eine Datei, einen Ordner, einen Zweig, eine Commit- oder Pull-Anfrage zu erwähnen, eine Datei anzuhängen oder Nour über andere Zweige zu informieren. Die Chips über dem Meldungsfeld zeigen What Nour is told; Der Bereichswähler entscheidet, welche Repositories der Chat abdeckt.

Überprüfen Sie Nour App-Aktionen

Im Agent-Modus kann Nour über seine eigenen Befehle in GitTree agieren: Ansichten öffnen, bereitstellen, festschreiben, abrufen, pushen und mehr. Jede Aktion gehört zu einer Art (Look around, Change you can undo, Risky) und folgt Ihrer Wahl dafür; Alles, was riskant ist, wartet immer darauf, dass Sie auf eine Genehmigungskarte klicken.

Entwerfen Sie eine Commit- oder Pull-Anfrage

Das Commit-Feld und das Pull-Request-Dialogfeld können ihren Text mit einer von Ihnen installierten Coding-Agent-CLI entwerfen: Generate commit message with … liest Ihre bereitgestellten Änderungen und Draft the title and description with … liest die Commits Ihres Zweigs. Sie prüfen und bearbeiten den Entwurf; Es wird nichts festgeschrieben oder geöffnet, bis Sie die Taste drücken.

Verwalten Sie Nour Sitzungen

Jeder Chat wird pro Repository in Chat history gespeichert. Stop beendet die aktuelle Antwort; Nour stoppt auch einen Agenten, der zu lange nichts druckt. Wenn der ausgewählte Agent nicht antworten kann (nicht angemeldet, keine Nutzung übrig, fehlendes Modell), antwortet möglicherweise stattdessen ein anderer installierter Agent und Nour gibt den Grund an.

Lesen Sie Nour Datenschutz und Wiederherstellung

Vor jeder Runde, die Dateien ändern kann, speichert Nour einen Schnappschuss des Arbeitsbaums; Changes from this turn listet auf, was sich geändert hat, und Undo this turn stellt den Arbeitsbaum wieder her. Ein Snapshot deckt keine Pushs oder Dateien außerhalb des Repositorys ab. Ihre Nachrichten werden gemäß den Richtlinien des jeweiligen Anbieters an die von Ihnen ausgewählte Agenten-CLI weitergeleitet. GitTree speichert niemals einen API-Schlüssel oder ruft selbst ein Modell auf.

Konfigurieren Sie Agenten und Modelle

Einstellungen › Nour (AI) › Agents listet die gefundenen Agent-CLIs GitTree auf, die mit Installed oder Not installed gekennzeichnet sind. Wählen Sie das Agent for new chats, ein Model für jedes (leer verwendet die eigene Standardeinstellung des Agenten) und das Automatic selection order, das auf First one installed folgt. Test prüft, ob ein Agent auf diesem Computer funktioniert.

Suchen und ändern Sie die Einstellungen

Die Einstellungen verfügen über eine Seite pro Bereich, z. B. General, Profiles, SSH, Integrations, Nour (AI), External Tools und UI Customization sowie Repo-Specific Preferences für jedes geöffnete Repository. Search preferences findet eine Einstellung nach Name, Beschreibung oder Schlüssel und jede Einstellung gibt an, wo sie Saves to ist: App, Profile oder Repository.

Aussehen und Sprache

Einstellungen › Oberflächenanpassung legt die Sprache fest (zehn Sprachen: Englisch, Arabisch von rechts nach links, Japanisch, vereinfachtes Chinesisch, Deutsch, Koreanisch, Französisch, Hindi, Spanisch und Italienisch), außerdem das Design (hell, dunkel und kontrastreich), Dem Systemerscheinungsbild folgen, den Zoom (%), wie Datumsangaben angezeigt werden, und Bewegung reduzieren.

Konfigurieren Sie das Git- und Repository-Verhalten

Einstellungen › General enthält, wie GitTree Git antreibt: die Optionen Git executable, Pull mode, Auto-fetch interval, Rebase, Long paths und Line endings. Repo-Specific Preferences überschreibt einige davon für ein Repository, z. B. Base branch, automatisches Abrufen, Commit-Vorlage und wie es Dateiänderungen erkennt.

Verwalten Sie Git-Identitäten und -Profile

Ein Profil ist ein Name und eine E-Mail-Adresse für Commits sowie ein optionaler Signaturschlüssel und ein SSH-Befehl, zwischen denen Sie wechseln können. Standardmäßig werden Passed to each git command GitTree ausgeführt, daher wird ~/.gitconfig nie geändert und der eigene Name oder die E-Mail-Adresse eines Repositorys gewinnt weiterhin; Written to ~/.gitconfig sorgt dafür, dass jedes Git-Tool es verwendet.

Konfigurieren Sie SSH in GitTree

Einstellungen › SSH listet die Schlüssel in Ihrem Ordner .ssh auf, erstellt neue, zeigt jeden Host aus Ihrer SSH-Konfiguration an und testet eine Verbindung. GitTree startet niemals einen SSH-Agenten und bearbeitet niemals ~/.ssh/config oder core.sshCommand; Ein Schlüssel, den Sie für SSH-Remotes auswählen, wird an die von ihm ausgeführten Git-Befehle übergeben.

Konfigurieren Sie Commit und Tag-Signierung

Einstellungen › Commit Signing wählt Format (OpenPGP, SSH-Schlüssel oder X.509) und Key aus und gibt an, ob Sign every commit und Sign every annotated tag verwendet werden sollen. Es wird nichts geschrieben, bis Sie Apply to Global Git Config drücken. Das Diagramm und die Commit-Details zeigen dann den Signaturstatus jedes Commits an.

Konfigurieren Sie Tools und Dateikodierung

Diffs und Dateien, die nicht UTF-8 sind, werden mit Preferences › Editor › Default encoding gelesen; Eine Byte-Reihenfolge-Markierung gewinnt immer, und Bytes, die nicht passen, werden als � angezeigt. Line endings (core.autocrlf) entscheidet, wie Git CRLF und LF konvertiert, und Long paths lässt Git Pfade mit mehr als 260 Zeichen auf Windows erstellen.

Konfigurieren Sie Benachrichtigungen und Protokollierung

Einstellungen › Notifications legt Where notifications appear fest, ob auf Show success notifications und Desktop notifications von Ihrem System aus. Extended logging in General schreibt ab dem nächsten Start weitere Details in das lokale Protokoll, um die Diagnose eines Problems zu erleichtern; Es wird nichts irgendwo hingeschickt.

Konfigurieren Sie Nour-Berechtigungen

Zwei Einstellungen sind an Nour gebunden. What Nour may do in a repository legt fest, was der Agent selbst dort tun darf: Read only, Edit files, no commands oder Everything, as in a terminal. What Nour may do in GitTree legt für jede Art und jeden Bereich der App-Aktion Never, Ask me first oder On its own fest; Bei riskanten Veränderungen immer nachfragen.

Konfigurieren Sie die Integrationsaktualisierung

Einstellungen › Integrations steuert, wie GitTree Ihre Hosting-Konten liest: wie alt die Listen vor Refresh pull requests, issues and checks werden dürfen, ob Refresh when I come back verwendet wird, CI/CD-Protokollstandards und woher Autorenbilder kommen. Das Lesen erfolgt nur, solange sich das Fenster von GitTree im Vordergrund befindet.

Einstellungen sichern, importieren oder zurücksetzen

Einstellungen › General › Back up, restore and reset exportiert Ihre App-Einstellungen, Profile und Git-Einstellungen in eine Datei, importiert eine solche Datei oder setzt alles zurück. Ein Export enthält niemals Passwörter, Token oder Kontodetails oder Einstellungen eines Repositorys. Git-Einstellungen aus einem Import werden erst nach Überprüfung in ~/.gitconfig geschrieben.

Suchen Sie nach Updates und installieren Sie sie

GitTree kann Git nicht finden

GitTree verwendet Ihre eigene Git-Installation und bündelt oder installiert niemals eine. Wenn keine gefunden wird, wird GitTree needs Git angezeigt. Wenn die gefundene Version älter als 2.39 ist, wird This Git is too old angezeigt. Installieren oder aktualisieren Sie Git oder drücken Sie Locate Git…, um es auszuwählen, und dann Check again.

Ein Repository wird nicht geöffnet

Wenn ein Ordner nicht geöffnet werden kann, sagt GitTree den Grund und bietet den nächsten Schritt an: This folder is not a Git repository (initialisieren oder einen anderen auswählen), This cannot be opened as a repository (fehlender Pfad), GitTree cannot read this folder (Berechtigungen) oder This repository belongs to another user (Gits Eigentumsprüfung).

Änderungen sind nicht erfrischend

GitTree bemerkt Änderungen, die in anderen Programmen vorgenommen wurden, über die Änderungsbenachrichtigungen Ihres Systems. Bei WSL-Ordnern und Netzwerkfreigaben kommen diese Benachrichtigungen nicht an, daher überprüft Automatic den Ordner stattdessen alle paar Sekunden. Wenn Änderungen immer noch zu spät angezeigt werden, erzwingen Sie den Prüfmodus für dieses Repository oder aktualisieren Sie es manuell.

Ein Remote-Authentifizierungsversuch ist fehlgeschlagen

Git meldet sich zunächst mit Ihrem eigenen Anmeldeinformations-Helper oder SSH-Schlüssel bei einem Remote-Gerät an. … needs you to sign in. bedeutet, dass nichts beantwortet wurde; … refused the credentials sent for this repository. bedeutet, dass das Gesendete nicht mehr gültig oder nicht zulässig ist. Korrigieren Sie die von Git verwendeten Anmeldeinformationen; Ein verbundenes Konto wird nur dann ausgefüllt, wenn Ihre Helfer nichts haben oder wenn Sie es für ein Repository auswählen.

Ein Push wurde abgelehnt

Ein Push wird aus einem von drei Gründen abgelehnt, und GitTree gibt an, welcher. The remote refused …: Die Fernbedienung hat Commits, Ihr Zweig nicht. The remote declined the push: Ein Hook- oder Branch-Schutz sagte „Nein“, mit Angabe des Grundes. … moved: Bei einem erzwungenen Push mit Lease wurde festgestellt, dass die Fernbedienung nicht mehr dort ist, wo Sie sie zuletzt abgerufen haben. Daher wurde nichts ersetzt.

Eine Git-Operation erfordert Aufmerksamkeit

Wenn eine Zusammenführung, ein Rebase, ein Cherry-Pick, ein Zurücksetzen oder eine Halbierung auf halbem Weg stoppt, zeigt GitTree ein Banner wie Rebasing … onto …, step 3 of 7 an und markiert die Registerkarte rebase in progress. Die meisten Befehle warten, bis der Vorgang abgeschlossen ist: Lösen Sie alle Konflikte, dann Continue, Skip den Schritt oder Abort…, um zum Ausgangspunkt zurückzukehren.

Eine Integrationsaktion ist nicht verfügbar

Wenn eine Hosting-Aktion nicht verwendet werden kann, sagt GitTree den Grund dafür, anstatt stillschweigend fehlzuschlagen. Die üblichen Gründe sind: Es ist Teil von GitTree Pro; Für den Remote-Host ist kein Konto verbunden. Der Token muss erneut verbunden werden. Ihre Rolle beim Anbieter lässt dies nicht zu; der Anbieter bietet es nicht an; oder der Anbieter schränkt die Anfragen für eine Weile ein.

Nour kann nicht beginnen oder enden

Nour führt eine Coding-Agent-CLI auf Ihrem Computer aus, sodass die meisten Probleme bei den CLIs liegen: nicht installiert, nicht angemeldet, keine Verwendung mehr vorhanden, das von Ihnen festgelegte Modell ist nicht verfügbar oder es benötigt Node.js. GitTree weigert sich auch, einen Zug in einem eingeschränkten Repository zu starten oder wenn der Snapshot nicht gespeichert werden kann, der den Zug rückgängig macht.

Eine Pipeline oder ein Protokoll kann nicht geladen werden

GitTree gibt an, warum ein Lauf oder Protokoll fehlt: This repository’s host does not list … runs., This log has expired on …, This account may not read logs here., … offers no log from outside its own page. oder dass der Anbieter Anfragen einschränkt. Die meisten haben einen Fix; manche öffnen nur die Seite des Anbieters.

Eine Schlüsselbund- oder SSH-Anfrage ist fehlgeschlagen

GitTree speichert Kontotokens, seine Anmeldung und gespeicherte SSH-Passphrasen nur in Ihrem Systemschlüsselbund: dem macOS Keychain, dem Windows Credential Manager oder dem Secret Service (GNOME Keyring oder KeePassXC) auf Linux. Wenn der Schlüsselbund „Nein“ sagt, fordert GitTree Sie auf, den Zugriff zu erlauben und es erneut zu versuchen; es greift nie auf eine Datei zurück.

Verwenden Sie GitTree, während Sie offline sind

GitTree ist lokal-zuerst: Jede lokale Git-Funktion funktioniert ohne Verbindung, einschließlich Commits, Branches, Merges, Rebases, Stashes, History und Undo. Fetch, Pull, Push, Hosting-Integrationen, CI/CD und Nours Anbieter benötigen das Netzwerk; während offline GitTree zeigt die zuletzt gelesenen Daten an und sagt dies.

Sammeln und teilen Sie einen Supportbericht

Wenn GitTree einen Fehler erkennt, speichert es einen Bericht auf diesem Computer. Es wird nichts irgendwo hingeschickt. Report a Bug… zeigt an, was kopiert werden würde (der gespeicherte Bericht mit entfernten Tokens und Passwörtern oder eine kurze Zusammenfassung), lässt Sie auswählen und öffnet dann das Support-Formular auf der GitTree-Website, damit Sie es einfügen können. Contact Support… schreibt an die Support-Adresse.