GitTree manuel de bureau

Utilisez GitTree pour votre travail quotidien

GitTree est un client Git de bureau pour macOS, Windows et Linux. Connectez-vous et chaque tâche Git locale est sur le plan gratuit : ouvrir, cloner, valider, créer une branche, fusionner, rebaser, cacher et annuler. GitTree Pro ajoute des intégrations d'hébergement, des exécutions CI/CD, la rédaction d'IA et Nour, l'assistant IA.

Installer GitTree sur macOS

GitTree pour Mac est une application universelle pour les Mac Apple Silicon et Intel sur macOS 13 ou version ultérieure, signée et notariée par Apple. Installez d'abord Git, ouvrez le .dmg, faites glisser GitTree vers Applications et démarrez-le.

Installer GitTree sur Windows

GitTree pour Windows est un programme d'installation 64 bits pour Windows 10 (22H2) et Windows 11. Installez d'abord Git for Windows, choisissez Microsoft Store ou l'EXE direct, et démarrez GitTree à partir du menu Démarrer.

Installer GitTree sur Linux

GitTree pour Linux est livré sous forme de .deb pour Ubuntu 22.04 ou version ultérieure et Debian 12 ou version ultérieure, et sous forme de AppImage portable, tous deux pour x86_64 64 bits. Installez d'abord Git 2.39 ou une version plus récente, puis installez le .deb avec apt ou exécutez le AppImage.

Trouvez Git et définissez votre identité de commit

GitTree exécute le Git installé sur votre ordinateur et n'en regroupe jamais un. Il a besoin de Git 2.39 ou plus récent, ainsi que d'un nom et d'une adresse e-mail pour vos commits (user.name et user.email), qu'il demande pour la première fois qu'un commit en a besoin.

Trouvez votre chemin GitTree

Un onglet de référentiel comporte six parties : la barre d'onglets, la barre d'outils, la barre latérale, le graphique de validation, l'inspecteur et la barre d'état. Cette page montre où se trouve chacun et ce que vous y faites.

Créez votre premier commit

Un commit enregistre un instantané des modifications que vous avez effectuées, avec un message expliquant pourquoi. Dans GitTree, vous préparez un fichier dans le panneau des modifications, saisissez un résumé et appuyez sur Commit : le nouveau commit apparaît en haut du graphique.

Utilisez Git local gratuitement et comprenez Pro

Chaque fonctionnalité Git locale dans GitTree est gratuite pour tous ceux qui se connectent avec un compte GitTree. GitTree Pro ajoute Nour, les intégrations d'hébergement et la rédaction d'IA ; vous pouvez les essayer avec un essai gratuit qui ne démarre que lorsque vous le demandez.

Ouvrir un référentiel existant

Choisissez le dossier d'un référentiel Git déjà présent sur votre ordinateur et GitTree l'ouvre dans son propre onglet, avec son graphique de commit, ses branches et ses modifications. Rien n'est téléchargé : le référentiel reste sur votre ordinateur.

Cloner un dépôt

Le clonage copie un référentiel de GitHub, GitLab, Bitbucket, Azure DevOps ou n'importe quel serveur Git sur votre ordinateur, avec son historique. Dans GitTree, collez l'URL, choisissez où elle va et appuyez sur Clone ; il s'ouvre dans un nouvel onglet une fois terminé.

Créer un référentiel

L'initialisation transforme un dossier en dépôt Git, de la même manière que git init. Dans GitTree vous choisissez le dossier et la branche initiale, ajoutez éventuellement un .gitignore et une licence, et appuyez sur Initialize.

Utiliser les référentiels récents et favoris

Le nouvel onglet répertorie les référentiels que vous avez ouverts sous Recent et ceux que vous avez marqués sous Favourites. Sélectionnez-en un pour l’ouvrir dans un onglet. Les listes restent sur cet ordinateur.

Rechercher des référentiels sur le disque

Scan for Repositories… parcourt un dossier que vous choisissez et répertorie chaque dépôt Git jusqu'à trois dossiers. Rien n'est ouvert jusqu'à ce que vous le choisissiez ; vous pouvez en ouvrir un ou les ajouter à un espace de travail.

Examiner la confiance du référentiel

Certains référentiels contiennent des paramètres ou des hooks Git qui exécutent des programmes sur votre ordinateur lorsque Git y fonctionne. Avant que cela ne se produise, GitTree affiche à Trust this repository? exactement ce qu'il a trouvé et vous permet de lui faire confiance ou de l'ouvrir dans Restricted mode.

Ouvrir un dépôt nu

Un référentiel nu a un historique mais aucun fichier de travail, comme ceux que les serveurs conservent pour que d'autres puissent y accéder (git init --bare, git clone --bare). GitTree l'ouvre pour afficher le graphique, les branches et les balises, marque son onglet bare et désactive les actions nécessitant des fichiers de travail.

Gérer les onglets du référentiel

Chaque référentiel s'ouvre dans son propre onglet en haut de la fenêtre. Les onglets affichent l'état du référentiel, comme les modifications non validées ou un rebase en cours, et vous basculez entre eux à partir du clavier.

Lire le graphique de validation

Le graphique de validation montre l'historique du référentiel sous forme de lignes, la plus récente en premier, avec des voies qui se divisent là où les branches commencent et se rejoignent là où elles fusionnent. Les étiquettes sur les lignes affichent les branches et les balises ; une coche indique la branche sur laquelle vous vous trouvez.

Trouver un commit

Appuyez sur Ctrl+F (⌘F sur un Mac) dans le graphique et saisissez une partie d'un message de commit, un auteur, un SHA, une branche ou une balise. GitTree met en évidence les matchs et les mouvements entre eux ; Filter Graph réduit l'historique lui-même.

Inspecter un commit

Sélectionnez une validation dans le graphique et l'inspecteur de droite affiche tout ce qui la concerne : le message, le SHA complet, ses parents, qui l'ont écrit et validé, et les fichiers qu'il a modifiés. Sélectionnez un fichier pour voir sa différence.

Concentrer et filtrer le graphique

Dans un référentiel chargé, Focus on Current Branch affiche uniquement votre branche, son amont et sa base, avec le nombre de commits dont elle dispose depuis la base. Filter Graph… conserve les commits d'un auteur, une plage de dates ou un chemin. Le filtrage ne supprime jamais l'historique ; Clear Graph Filter ramène chaque ligne.

Personnaliser les colonnes du graphique

Le graphique montre les étiquettes des branches, les voies et le message par défaut. Le menu Graph columns ajoute des colonnes Author, Date et SHA et passe aux lignes compactes ; vous pouvez redimensionner chaque colonne et masquer les panneaux latéraux.

Comparez les commits et agissez sur une sélection

Sélectionnez deux commits en maintenant Ctrl (⌘ sur un Mac) enfoncé et choisissez Compare These Two Commits pour voir tous les fichiers qui diffèrent. Une sélection de plusieurs commits a ses propres actions : copier les SHA, sélectionner, annuler, écraser ou créer un correctif.

Utiliser le glisser-déposer du graphique

Faites glisser une étiquette de branche sur une autre branche du graphique et GitTree propose ce que les deux peuvent faire : Fast-forward, Merge ou Rebase. Rien ne se passe jusqu'à ce que vous choisissiez ; la confirmation habituelle et Annuler s'appliquent.

Examiner les modifications apportées au travail

Le panneau Working Changes est le git status de GitTree : il répertorie tous les fichiers que vous avez modifiés depuis le dernier commit, divisé en Unstaged Files et Staged Files, et affiche la différence du fichier que vous sélectionnez.

Fichiers de scène, morceaux et lignes sélectionnées

Un commit contient uniquement ce que vous mettez en scène. Dans GitTree, vous préparez un fichier entier, un morceau de celui-ci ou simplement les lignes que vous sélectionnez dans le diff, et le reste de vos modifications reste dans le dossier de travail pour une validation ultérieure.

Écrivez un message de validation et validez

Le formulaire de validation se trouve sous vos fichiers préparés : une ligne Summary, un Description facultatif et Commit Options pour les co-auteurs, la signature, les hooks et le push par la suite. GitTree signale les erreurs courantes dans les messages avant de vous engager.

Modifier le dernier commit

La modification remplace le dernier commit par un nouveau contenant votre message corrigé et toutes les modifications que vous effectuez maintenant, comme git commit --amend. Dans GitTree, il s'agit du commutateur Amend Previous Commit dans le formulaire de validation.

Annuler les modifications et nettoyer les fichiers non suivis

La suppression ramène les fichiers à leur dernier état validé ou intermédiaire, comme git restore ; le nettoyage supprime les fichiers que Git ne suit pas, comme git clean. GitTree enregistre d'abord un instantané de récupération, afin que Undo puisse les restaurer.

Choisir et utiliser une vue différentielle

Chaque différence dans GitTree peut être affichée sous la forme Hunk, Inline ou Split (côte à côte). Mettez en surbrillance les mots modifiés, enveloppez les longues lignes, ignorez les modifications d'espaces, prévisualisez Markdown et passez d'une modification à la suivante.

Ignorer les fichiers de GitTree

Les fichiers que vous ne souhaitez jamais valider, tels que la sortie de build ou les paramètres locaux, appartiennent à .gitignore. Cliquez avec le bouton droit sur un nouveau fichier dans vos modifications de travail et choisissez ce que vous souhaitez ignorer, ou modifiez .gitignore directement avec Edit .gitignore….

Créer et appliquer des correctifs

Un patch est un fichier qui transporte les modifications d'un référentiel à un autre. GitTree enregistre les modifications d'un fichier ou un ou plusieurs commits en tant que correctif et applique un correctif à votre arborescence de travail, par étapes ou en tant que commits sur la branche actuelle.

Examiner les images et les modifications binaires

Les différences de texte ne peuvent pas afficher une image. Lorsqu'une image PNG, JPEG, GIF, WebP ou autre change, GitTree compare les images avant et après : Side by side, Swipe ou Onion skin. D'autres fichiers binaires affichent leurs tailles.

Gérer les indicateurs d'index de fichiers suivis

Parfois, vous modifiez un fichier suivi uniquement sur votre ordinateur, comme une configuration locale. Deux indicateurs Git masquent ces modifications : Skip Worktree… conserve votre copie et cesse d'afficher ses modifications ; Assume Unchanged… est une accélération qui empêche Git de vérifier le fichier. Ce n’est pas non plus un moyen d’ignorer un fichier.

Créer et changer de branche

Une succursale est un nom mobile pour un secteur d'activité. Dans GitTree, Branch dans la barre d'outils en crée un au niveau du commit sur lequel vous vous trouvez ; cliquez avec le bouton droit sur n’importe quel commit pour en créer un ici. Double-cliquez sur une étiquette de branche pour y accéder.

Renommer et supprimer des branches

Cliquez avec le bouton droit sur une étiquette de branche pour Rename et Delete. La suppression d'une branche locale enregistre d'abord son dernier commit sous refs/ogt/trash, donc Undo le ramène ; la suppression sur la télécommande est un choix distinct et clairement nommé.

Créer et gérer des balises

Une balise est un nom fixe pour un commit, généralement une version telle que v2.2.0. Cliquez avec le bouton droit sur un commit, choisissez Tag Here, puis une balise légère ou annotée. Les balises ne sont pas poussées avec vos commits : poussez chacune d'elles avec Push Tag.

Définir le suivi et publier une branche

Une nouvelle branche n'existe que sur votre ordinateur jusqu'à ce que vous la poussiez. Le premier Push demande à quelle télécommande l'envoyer, et à partir de là, la branche suit cette branche distante (en amont), comme git push -u. Set Upstream… modifie ce qu'il suit.

Comparez les branches et les balises

Compare References… compare deux branches, balises, branches distantes ou commits par nom. Il montre combien de commits l'un est en avance et en retard sur l'autre, ainsi que les fichiers qui diffèrent : soit chaque différence (git diff A B), soit seulement ce que le nouveau côté a changé depuis leur séparation (A...B, ce que montre une pull request).

Utiliser les actions Gitflow

Gitflow est un modèle de branchement avec une branche de production, une branche de développement et des branches de fonctionnalités, de versions et de correctifs. La section Gitflow de GitTree l'initialise et démarre et termine ces branches, en les fusionnant, en les marquant et en les supprimant pour vous.

Reconnaître et laisser détaché la TÊTE

Extraire un commit ou une balise au lieu d'une branche vous met sur un detached HEAD : vous n'êtes sur aucune branche. Vous pouvez regarder autour de vous et même valider, mais les nouveaux commits n'appartiennent à aucune branche. Créez une branche pour les conserver, ou consultez une branche pour y revenir.

Récupérer, tirer et pousser

Fetch télécharge les nouveautés sur vos télécommandes sans modifier votre travail. Pull y intègre l'amont de votre branche. Push envoie vos commits à la télécommande. Tous les trois se trouvent dans la barre d'outils, avec leurs options dans les menus fléchés à côté d'eux.

Ajouter et modifier des télécommandes

Une télécommande est une copie nommée du référentiel ailleurs, comme origin sur GitHub. La section Remote du panneau de gauche les répertorie ; Add Remote… en ajoute un et, en cliquant avec le bouton droit sur une télécommande, le modifie, le récupère, l'élague ou le supprime.

Choisissez les informations d'identification à distance

GitTree exécute votre propre Git, alors récupérez, tirez et poussez la signature comme Git le fait sur votre ordinateur : via HTTPS via votre assistant d'identification, via SSH avec votre clé ou votre agent SSH. Les mots de passe et les jetons restent dans le trousseau de votre système, jamais dans les fichiers de GitTree.

Configurer la récupération automatique

La récupération automatique maintient les branches distantes de votre graphique à jour sans que vous appuyiez sur Fetch All. Définissez le Auto-fetch interval en minutes pour chaque référentiel ouvert, remplacez-le pour un référentiel et recevez une notification sur le bureau lorsque de nouvelles validations arrivent.

Utiliser une poussée forcée avec bail

Après avoir modifié, rebasé ou réinitialisé les commits que vous avez déjà poussés, un push normal est refusé. Force Push (With Lease)… remplace la branche distante par la vôtre, mais seulement si elle se trouve toujours là où vous l'avez récupérée pour la dernière fois, comme git push --force-with-lease. GitTree ne force jamais autrement.

Travailler avec un historique de référentiel limité

Un clone superficiel télécharge uniquement les derniers commits ; un clone sans tache télécharge le contenu du fichier uniquement en cas de besoin. Les deux créent d’énormes référentiels rapides à cloner. Dans un clone superficiel, le graphique montre où l'histoire s'arrête, et Fetch More History ou Fetch Full History amène le reste.

Fusionner les branches

La fusion amène les commits d'une autre branche dans la branche sur laquelle vous vous trouvez, comme git merge. Cliquez avec le bouton droit sur l'autre branche et choisissez Merge … into … : GitTree vérifie d'abord les conflits et vous permet de choisir la manière dont la fusion est enregistrée.

Rebaser une branche

Le rebasage rejoue les commits de votre branche au-dessus d'une autre branche, de sorte que l'historique reste une ligne droite, comme git rebase. Les commits obtiennent de nouveaux identifiants ; GitTree conserve l'ancienne branche sous refs/ogt/trash et Undo la ramène.

Résoudre les conflits de fusion

Un conflit se produit lorsque les deux branches modifient les mêmes lignes. Le résolveur de GitTree affiche les deux versions côte à côte, A et B : cochez les lignes à conserver dans chaque conflit, cochez le Output, puis Save et continuez la fusion, le rebase ou le tri.

Sélectionner et annuler les commits

Cherry-Pick Commit copie les modifications d'un commit sur votre branche actuelle en tant que nouveau commit, comme git cherry-pick. Revert Commit ajoute un nouveau commit qui en annule un, comme git revert : le moyen sûr de reprendre quelque chose déjà poussé.

Continuer, ignorer ou abandonner une opération

Une fusion, un rebase, un Cherry-pick ou un retour peuvent s'arrêter à mi-chemin, généralement en cas de conflit. Une bannière au-dessus du graphique nomme l'opération et son étape, et propose Resolve, Continue, Skip (rebase) et Abort…. L'abandon enregistre ce qu'il laisse tomber en premier, donc Undo le ramène.

Réutiliser les résolutions de conflits enregistrées

Avec Reuse recorded resolutions (rerere) activé, Git se souvient de la manière dont vous avez résolu un conflit et écrit la même résolution lorsque ce conflit revient, lors d'un rebase répété par exemple. GitTree vous indique quand cela s'est produit et vous permet de l'examiner avant de marquer le fichier comme résolu.

Modifier l'historique avec un rebase interactif

Un rebase interactif réécrit les commits au-dessus de celui choisi : conservez, reformulez, modifiez, écrasez, corrigez ou supprimez chacun, et faites-les glisser dans un nouvel ordre, comme git rebase -i. Pour un seul changement, Edit History dans le menu d'un commit le fait en une seule étape.

Squash s’engage

Le Squashing combine plusieurs commits en un seul, comme un fixup ou un squash dans git rebase -i. Dans GitTree, chaque squash ouvre d'abord la boîte de dialogue Squash : elle affiche les commits qui se terminent, le résultat, le message et qui obtient le crédit, et rien ne change jusqu'à ce que vous confirmiez. Votre travail non validé n'est jamais touché et Undo remet les validations.

Modifier les commits locaux sélectionnés

Pour une modification rapide de l'historique, vous n'avez pas besoin de l'ensemble de l'éditeur de rebase interactif. Le menu Edit History d'un commit modifie son message, le supprime ou le déplace vers le haut ou vers le bas ; la sélection de plusieurs commits ouvre la boîte de dialogue Squash. GitTree réécrit les commits au-dessus et conserve l'ancienne branche, donc Undo la remet.

Réinitialiser une branche en commit

La réinitialisation déplace votre branche actuelle vers un autre commit, comme git reset. Soft conserve chaque modification par étapes, Mixed les conserve dans votre dossier de travail, Hard les supprime. GitTree enregistre d'abord tout sous refs/ogt/trash, de sorte que même une réinitialisation matérielle peut être annulée.

Annuler et refaire

GitTree enregistre vos opérations Git afin que Undo dans la barre d'outils puisse reprendre la dernière : une validation, une fusion, un rebase, une réinitialisation, une suppression, un nettoyage, une branche ou une balise supprimée. Redo recommence. Les étapes destructrices enregistrent un instantané de récupération sous refs/ogt/trash avant d'être exécutées.

Retrouvez les conseils des succursales précédentes

Le reflog enregistre l'endroit où pointait une branche ou HEAD, à chaque fois qu'elle se déplaçait : validations, extractions, réinitialisations, rebases. View Reflog… répertorie ces entrées ; choisissez-en un pour afficher son commit dans le graphique ou Restore as Branch.

Historique des fichiers et blâme

History répertorie tous les commits qui ont modifié un fichier, après les renommages, comme git log --follow. Blame affiche, pour chaque ligne, le commit et l'auteur qui l'a modifié en dernier, comme git blame. Les deux sont des vues de l’espace de travail des fichiers.

Utiliser le flux de travail bissectrice

Bisect trouve le premier commit qui a introduit un problème en réduisant de moitié l'historique entre un commit qui l'a et un qui ne l'a pas, comme git bisect. Sélectionnez les deux commits, testez le commit GitTree, marquez-le Good ou Bad et répétez jusqu'à ce qu'il nomme le First bad commit.

Exporter une archive

Export Archive… écrit les fichiers d'un commit, d'une branche ou d'une balise au format .zip ou .tar.gz, sans le dossier .git, comme git archive. C’est le moyen le plus rapide de transmettre à quelqu’un la source d’une version.

Utiliser la maintenance du référentiel et les outils de création

Repository Maintenance… affiche la taille de la base de données d'objets et exécute des tâches qui la vérifient ou accélèrent l'historique et l'état. Merge Author Identities… écrit .mailmap lignes afin qu'une personne avec plusieurs noms ou adresses e-mail s'affiche comme un seul auteur.

Organiser les espaces de travail

Un espace de travail est un ensemble nommé de référentiels qui s'ouvre comme une unité, telle que « Client A » ou « Mobile ». Son tableau de bord affiche la branche, l'état de synchronisation et les modifications de chaque référentiel, ainsi que les demandes d'extraction et les exécutions CI/CD à travers eux.

Gérer les référentiels enregistrés

Chaque espace de travail conserve une liste de Saved repositories : chaque référentiel que vous ouvrez, clonez, créez ou ajoutez à partir d'une analyse alors qu'il s'agit de l'espace de travail actuel y est enregistré et y reste après la fermeture de son onglet. Ouvrez-les de la liste, d'un seul coup, ou supprimez-en un ; son dossier n'est jamais touché.

Cacher les modifications

Une réserve met de côté vos modifications non validées et vous donne un dossier de travail propre, comme git stash, afin que vous puissiez changer de tâche et ramener les modifications plus tard. Stash dans la barre d'outils enregistre tout ; L'onglet Stash du panneau des modifications choisit exactement quoi.

Travailler sur plusieurs branches avec des worktrees

Un arbre de travail est un deuxième dossier de travail pour le même référentiel, avec sa propre branche extraite, comme git worktree add. Examinez une pull request, exécutez une longue build ou laissez un agent de codage travailler dans l’un, sans rien cacher dans l’autre.

Gérer les sous-modules

Un sous-module est un autre référentiel épinglé dans le vôtre lors d'une validation spécifique. GitTree les répertorie avec leur état (non initialisés, à jour, commit différent, en conflit) et les ajoute, initialise, met à jour, ouvre, modifie et supprime.

Utiliser les contrôles Git LFS

Git LFS stocke les fichiers volumineux, tels que les images, les vidéos ou les modèles, en dehors du référentiel et conserve les petits fichiers pointeurs à leur place. Git LFS… le configure, suit les modèles, télécharge le contenu, verrouille les fichiers et supprime l'ancien contenu.

Parcourir et modifier les fichiers de projet

La section Files du panneau de gauche affiche les dossiers de votre projet, marquant ceux qui contiennent les modifications. Ouvrez un fichier pour le lire ou le modifier dans un onglet à côté de l'onglet Graph et basculez-le entre File, Changes, Blame et History.

Ouvrir et modifier des fichiers

Un fichier que vous ouvrez dans GitTree obtient son propre onglet à côté de l'onglet Graph épinglé. Un fichier provenant d'un commit est en lecture seule ; Edit in Working Directory ouvre la copie dans votre projet à modifier et Save. Si le fichier change sur le disque entre-temps, GitTree n'enregistre rien et vous laisse choisir.

Revenir au graphique de validation

Les différences, les fichiers, les reproches, l'historique, les comparaisons, les pipelines et les demandes d'extraction s'ouvrent sur le graphique. Esc ferme celle du haut et revient à la vue qui l'a ouverte ; Back to Graph les enlève tous en même temps. Les fichiers ouverts se masquent uniquement : leurs onglets restent à côté de l'onglet Graph.

Utiliser le terminal intégré

Terminal dans la barre d'outils ouvre un shell à la racine du référentiel dans le tiroir sous le graphique. Exécutez n'importe quelle commande ici, Git inclus : le graphique et vos modifications sont mis à jour au fur et à mesure. Chaque onglet du référentiel conserve ses propres terminaux.

Configurer des outils externes

Préférences › External Tools choisit les ouvertures Editor, Diff tool et Merge tool GitTree dans les menus de fichiers et la vue des conflits. Automatic utilise la première installation de Visual Studio Code, Cursor et Antigravity ; Custom… exécute n'importe quel programme avec les arguments que vous donnez.

Créer et exécuter des actions personnalisées

Les commandes personnalisées exécutent vos propres programmes sur un référentiel à partir du bouton Custom actions et des menus de validation, de branche et de fichier. Chaque argument est passé exactement tel qu'il est écrit, aucun shell n'est impliqué et la première exécution d'une commande montre exactement ce qui sera exécuté avant elle.

Rechercher des actions avec la palette de commandes

La palette de commandes exécute n'importe quelle commande GitTree en tapant une partie de son nom, et accède également aux branches, commits, fichiers et référentiels ouverts. Appuyez sur Ctrl+Shift+P (⌘⇧P sur un Mac), tapez et appuyez sur Entrée.

Raccourcis clavier

La plupart des commandes GitTree ont un raccourci. Appuyez sur Ctrl+/ (⌘/ sur un Mac) pour la liste complète dans l'application, filtrée au fur et à mesure que vous tapez ; Customize… il change n'importe lequel d'entre eux. Les tableaux ci-dessous répertorient les valeurs par défaut.

Inspecter l'activité et les notifications

Le Activity Log répertorie chaque commande git GitTree exécutée, avec sa sortie, combien de temps cela a pris et si elle a échoué ; les jetons, mots de passe et informations d’identification dans les URL sont supprimés. Notifications conserve les messages affichés dans cette session et Préférences › Notifications décide quelles fenêtres contextuelles s'affichent et si votre système les affiche également.

Utilisez le guide des fonctionnalités intégré à l'application

Le Feature Guide répertorie tout ce que GitTree peut faire, où le trouver et ses raccourcis, regroupés par zone, avec un champ de recherche. Show me vous amène à la fonctionnalité du référentiel que vous avez ouvert ; les fonctionnalités qui nécessitent un référentiel, Pro ou un compte connecté le disent.

Connectez-vous GitHub

La connexion GitHub permet à GitTree de répertorier vos référentiels, vos demandes d'extraction, vos problèmes et vos vérifications. Connectez-vous avec votre navigateur (recommandé : vous approuvez GitTree sur la propre page de GitHub) ou utilisez un jeton d'accès personnel. Le jeton est conservé uniquement dans le trousseau de votre système.

Connectez-vous GitLab

GitTree se connecte à gitlab.com ou à un hôte GitLab autogéré que vous nommez. Connectez-vous avec le navigateur via une application OAuth (pour gitlab.com, GitTree est utilisé) ou utilisez un jeton d'accès personnel de cet hôte. Le jeton est utilisé uniquement pour cet hôte.

Connecter Bitbucket Cloud

GitTree se connecte à Bitbucket Cloud (bitbucket.org) de trois manières : connectez-vous avec votre compte Bitbucket dans le navigateur, utilisez un jeton API Atlassian avec l'adresse e-mail du compte ou utilisez un jeton d'accès à un espace de travail, un projet ou un référentiel. Les jetons sont conservés uniquement dans le trousseau de votre système.

Connecter le centre de données Bitbucket

Pour un serveur Bitbucket Data Center d'entreprise, nommez son hôte, puis utilisez un jeton d'accès HTTP personnel à partir de celui-ci, ou connectez-vous avec le navigateur via le lien d'application OAuth entrant que votre administrateur a créé pour GitTree. GitTree ne parle qu'à cet hôte.

Connectez Azure DevOps

Connectez-vous avec votre compte Microsoft dans le navigateur ou utilisez un jeton d'accès personnel d'Azure DevOps. GitTree s'adresse à dev.azure.com et au service de profil de Microsoft pour trouver vos organisations, puis répertorie leurs référentiels, demandes d'extraction et pipelines.

Connectez les serveurs d'entreprise et auto-hébergés

GitTree se connecte aux propres serveurs de votre entreprise : GitHub Enterprise Server, autogérés GitLab et Bitbucket Data Center. Vous nommez l'hôte ; GitTree communique avec https:// cet hôte uniquement et le jeton est utilisé uniquement pour cet hôte. La connexion au navigateur nécessite une application OAuth que votre administrateur y a enregistrée.

Vérifier la disponibilité de l'intégration

Les prestataires ne proposent pas tous les mêmes choses. L'onglet Integrations du Guide des fonctionnalités affiche, pour le fournisseur du référentiel ouvert et votre compte, qu'est-ce que Available, qu'est-ce que Not offered by ce fournisseur et qu'est-ce que Coming soon.

Parcourir et créer des référentiels de fournisseurs

Avec un compte connecté, Clone a repository répertorie les référentiels de ce compte par Owner, avec recherche, vous n'avez donc pas besoin de copier une URL. Publish Repository… va dans l'autre sens : il crée le référentiel sur votre compte, l'ajoute en tant que distant et pousse votre branche.

Utilisez les fourchettes de GitTree

Un fork est votre propre copie d'un référentiel sur le fournisseur. Create Fork… demande au fournisseur d'en créer un ; Add Remote from Fork… ajoute un fork existant en tant que télécommande. La création d'un fork ne change rien dans votre référentiel jusqu'à ce que vous l'ajoutiez, et une télécommande existante n'est jamais remplacée.

Demandes de tirage

Avec un compte d'hébergement connecté, GitTree répertorie les demandes d'extraction du référentiel dans le panneau de gauche et ouvre chacune d'entre elles à côté du graphique : sa conversation, ses commits, ses fichiers et ses vérifications, avec Review… et Merge…. Les demandes d'extraction font partie de GitTree Pro.

Créer une demande de tirage ou de fusion

Faites un clic droit sur votre branche et choisissez Start a Pull Request…. Choisissez ce qu'il fusionne From et Into, écrivez les Title et Description, ajoutez des réviseurs, éventuellement Open as a draft, et appuyez sur Create Pull Request. Une branche qui n'est pas encore sur la télécommande est poussée en premier.

Examiner et discuter des changements

Ouvrez la demande d'extraction, lisez Files et appuyez sur + à côté d'une ligne pour ajouter un commentaire de ligne à votre avis. Review… envoie votre décision (Approve, Request changes ou Comment) avec un Summary et un commentaire sur chaque ligne. Les conversations peuvent recevoir une réponse et être résolues là où le fournisseur le prend en charge.

Fusionner ou fermer une pull request

Merge… demande au fournisseur comment la demande d'extraction peut être fusionnée, indique s'il s'agit de Ready to merge et propose uniquement les Merge method autorisés par le référentiel. GitTree fusionne uniquement lorsque le head est toujours le commit que vous avez consulté ; si de nouveaux commits arrivent, rien n'est fusionné.

Utiliser les actions de problème prises en charge

La section Issues du panneau de gauche répertorie les problèmes ouverts du référentiel. Ouvrez-en un pour le lire et le commenter, créez-en un avec New Issue… ou commencez à travailler avec Create Branch from Issue…. Des problèmes de fermeture et de modification surviennent sur la page du fournisseur : Open Issue in Browser.

Inspecter les contrôles et le statut de validation

GitTree affiche l'état CI des commits et des pull request : Checks passing, Checks failing, Checks running, Checks skipped ou No checks reported, avec le nombre de réussites, d'échecs, d'exécutions ou ignorés. Sélectionnez-le pour voir les exécutions, ouvrir un journal de contrôle ou Re-run Check.

Exécutions CI/CD

GitTree affiche les exécutions CI/CD de l'hôte de votre référentiel, telles que les actions GitHub, dans le panneau de gauche et dans une liste complète à côté du graphique : ce qui a réussi, ce qui a échoué et pourquoi, avec Re-run Failed Jobs, Cancel Run… et Run Workflow…. CI/CD fait partie de GitTree Pro.

Parcourir et filtrer les exécutions

La liste CI/CD affiche chaque exécution du référentiel et se met à jour automatiquement au fur et à mesure des exécutions. Filters réduisez-le de Branch, Workflow, Status et Trigger ; Mine conserve vos courses ; Watch maintient une exécution mise à jour en arrière-plan et vous indique quand elle se termine.

Lire les tâches et les journaux

Ouvrez une exécution et sélectionnez une tâche ou une étape pour lire son journal dans l'onglet Log. Jump to first error va directement à l'échec, Search the log… trouve du texte, Timestamps et Wrap modifient la vue, Following garde en vue la sortie en direct d'une tâche en cours et Save Log… l'écrit dans un fichier.

Réexécuter ou annuler un pipeline

À partir d'une exécution, Re-run Failed Jobs répète uniquement ce qui a échoué, Re-run All Jobs répète tout et le menu d'une tâche réexécute uniquement cette tâche (Retry Stage sur des étapes de style GitLab). Cancel Run… l'arrête ; Force Cancel Run… y met fin sans laisser les tâches se nettoyer. Aucune des deux annulations ne peut être annulée.

Exécuter un flux de travail

Run Workflow… démarre un workflow qui peut être exécuté manuellement, tel qu'un workflow d'actions GitHub avec un déclencheur workflow_dispatch ou un pipeline Bitbucket custom. GitTree lit ses entrées à partir du fichier de workflow dans la branche que vous choisissez et affiche un champ pour chacune.

Télécharger les artefacts disponibles

L'onglet Artifacts d'une exécution répertorie les fichiers qu'elle a produits, avec Name, Size et quand Expires. Save… demande où le sauvegarder et le télécharge là, car le fournisseur le stocke ; un zip est enregistré sous forme de zip et GitTree ne l'ouvre pas.

Inspecter les déploiements et les environnements

Une exécution qui déploie affiche Deploys to … et un onglet Environments : chaque environnement, son déploiement, sa branche ou sa validation et quand. Un déploiement qui attend affiche Waiting for approval ; si vous êtes l'un de ses évaluateurs, Approve Deployment… et Reject Deployment… agissent en conséquence. Cela change les choses pour tout le monde et ne peut être annulé.

Créer et vérifier les fichiers de pipeline

New CI/CD File… écrit un fichier de démarrage là où votre fournisseur le lit, tel que .github/workflows/ ou .gitlab-ci.yml ; il n'écrit jamais sur un fichier existant. Modifiez-le dans GitTree, appuyez sur Check with … pour que le fournisseur le valide, puis validez-le comme n'importe quel fichier.

Gérer les paramètres du pipeline

CI/CD Settings montre ce que le fournisseur permet à une autre application de gérer : Variables, Secrets, Environments, Runners, Schedules, Caches, Definitions et Releases. La valeur d'un secret est saisie dans une invite système sécurisée ou lue à partir d'un fichier de votre choix, et est transmise directement au fournisseur ; GitTree ne l'affiche, ne le conserve ni ne l'envoie jamais ailleurs.

Utiliser les contrôles de version du pipeline

CI/CD Settings › Releases répertorie les versions du référentiel. New Release nomme une balise (ou en crée une à partir d'une branche ou d'un commit), avec un Title, Notes (Markdown) et des fichiers que les utilisateurs peuvent télécharger. Une version est publiée pour tous ceux qui peuvent voir le référentiel, sauf si vous Save as a draft.

Interrogez Nour à propos d'une panne de pipeline

Explain Failure ouvre Nour avec une question sur un échec d'exécution. Nour lit le journal de l'étape ayant échoué (au maximum 64 Ko) uniquement si vous approuvez, à chaque fois, et répond en indiquant ce qui, selon lui, n'a pas fonctionné et ce qu'il faut essayer. Considérez la réponse comme un conseil : vérifiez-la par rapport au journal.

Configurer Nour, l'assistant IA

Nour est l'assistant IA de GitTree. Il exécute la CLI de l'agent de codage que vous utilisez déjà, telle que Claude Code, Codex ou Gemini CLI, avec votre propre abonnement : GitTree ne voit jamais vos clés. En mode Ask, Nour regarde et répond uniquement ; en mode Agent, il peut agir dans les limites de ce que vous autorisez. Nour fait partie de GitTree Pro.

Interrogez Nour sur votre travail

Nour connaît toujours le référentiel et la branche extraite du chat. Tapez @ pour mentionner un fichier, un dossier, une branche, une demande de validation ou d'extraction, joindre un fichier ou informer Nour d'autres branches. Les puces au-dessus de la boîte de message affichent What Nour is told ; le sélecteur de portée décide quels référentiels le chat couvre.

Examiner Nour actions de l'application

En mode Agent, Nour peut agir dans GitTree via ses propres commandes : ouvrir des vues, préparer, valider, récupérer, pousser, etc. Chaque action appartient à un genre (Look around, Change you can undo, Risky) et suit votre choix pour celle-ci ; tout ce qui est risqué attend toujours votre clic sur une carte d'approbation.

Rédiger une commit ou une pull request

La boîte de validation et la boîte de dialogue de demande d'extraction peuvent rédiger leur texte avec une CLI d'agent de codage que vous avez installée : Generate commit message with … lit vos modifications par étapes et Draft the title and description with … lit les validations de votre branche. Vous révisez et modifiez le brouillon ; rien n'est validé ou ouvert jusqu'à ce que vous appuyiez sur le bouton.

Gérer Nour sessions

Chaque discussion est conservée par référentiel dans Chat history. Stop termine la réponse en cours ; Nour arrête également un agent qui n'imprime rien pendant trop longtemps. Si l'agent choisi ne peut pas répondre (non connecté, aucune utilisation restante, modèle manquant), un autre agent installé peut répondre à la place et Nour explique pourquoi.

Vérifier Nour confidentialité et récupération

Avant chaque tour susceptible de modifier des fichiers, Nour enregistre un instantané de l'arborescence de travail ; Changes from this turn répertorie ce qui a changé et Undo this turn remet l'arborescence de travail. Un instantané ne couvre pas les push ou les fichiers en dehors du référentiel. Vos messages sont envoyés à l'agent CLI que vous avez choisi, selon la politique de son propre fournisseur ; GitTree ne stocke jamais de clé API ni n'appelle un modèle lui-même.

Configurer les agents et les modèles

Préférences › Nour (AI) › Agents répertorie les CLI d'agent GitTree trouvées, marquées Installed ou Not installed. Choisissez le Agent for new chats, un Model pour chacun (vide utilise la valeur par défaut de l'agent) et le Automatic selection order qui suit First one installed. Test vérifie qu'un agent fonctionne sur cet ordinateur.

Rechercher et modifier les préférences

Les préférences ont une page par zone, telle que General, Profiles, SSH, Integrations, Nour (AI), External Tools et UI Customization, plus Repo-Specific Preferences pour chaque référentiel ouvert. Search preferences recherche un paramètre par nom, description ou clé, et chaque paramètre indique où il se trouve Saves to : App, Profile ou Repository.

Apparence et langage

Préférences › UI Customization définit les Theme (versions claires, sombres et à contraste élevé), Follow the system appearance, les Language (anglais ou arabe, disposés de droite à gauche), Zoom, la manière dont les Dates sont affichés et Reduce motion.

Configurer le comportement de Git et du référentiel

Préférences › General indique comment GitTree pilote Git : les options Git executable, Pull mode, Auto-fetch interval, les options de rebase, Long paths et Line endings. Repo-Specific Preferences remplace certains d'entre eux pour un référentiel, comme son modèle de validation Base branch, de récupération automatique et la façon dont il remarque les modifications de fichiers.

Gérer les identités et les profils Git

Un profil est un nom et une adresse e-mail pour les validations, ainsi qu'une clé de signature facultative et une commande SSH, entre lesquelles vous pouvez basculer. Par défaut, il s'agit de Passed to each git command GitTree exécutions, donc ~/.gitconfig n'est jamais modifié et le nom ou l'adresse e-mail d'un référentiel l'emporte toujours ; Written to ~/.gitconfig oblige tous les outils Git à l'utiliser.

Configurez SSH dans GitTree

Préférences › SSH répertorie les clés de votre dossier .ssh, en crée de nouvelles, affiche chaque hôte de votre configuration SSH et teste une connexion. GitTree ne démarre jamais un agent SSH et ne modifie jamais ~/.ssh/config ou core.sshCommand ; une clé que vous choisissez pour les télécommandes SSH est transmise aux commandes git qu'elle exécute.

Configurer la validation et la signature des balises

Préférences › Commit Signing sélectionne le Format (OpenPGP, clé SSH ou X.509) et Key, et s'il faut Sign every commit et Sign every annotated tag. Rien n'est écrit jusqu'à ce que vous appuyiez sur Apply to Global Git Config. Le graphique et les détails de la validation affichent ensuite l’état de signature de chaque validation.

Configurer les outils et l'encodage des fichiers

Les différences et les fichiers qui ne sont pas UTF-8 sont lus avec Préférences › Editor › Default encoding ; une marque d'ordre d'octet gagne toujours, et les octets qui ne correspondent pas s'affichent comme �. Line endings (core.autocrlf) décide comment git convertit CRLF et LF, et Long paths permet à git de créer des chemins de plus de 260 caractères sur Windows.

Configurer les notifications et la journalisation

Préférences › Notifications définit Where notifications appear, s'il faut Show success notifications et Desktop notifications depuis votre système. Extended logging dans General écrit plus de détails dans le journal local, à partir du prochain lancement, pour aider à diagnostiquer un problème ; rien n'est envoyé nulle part.

Configurer les privilèges Nour

Deux paramètres liés Nour. What Nour may do in a repository définit ce que l'agent lui-même peut y faire : Read only, Edit files, no commands ou Everything, as in a terminal. What Nour may do in GitTree définit, pour chaque type et domaine d'action de l'application, Never, Ask me first ou On its own ; les changements risqués demandent toujours.

Configurer l'actualisation de l'intégration

Préférences › Integrations contrôle la manière dont GitTree lit vos comptes d'hébergement : quel âge les listes peuvent avoir avant Refresh pull requests, issues and checks, s'il faut le faire Refresh when I come back, les valeurs par défaut du journal CI/CD et la provenance des images des auteurs. La lecture n'a lieu que lorsque la fenêtre de GitTree est devant.

Sauvegarder, importer ou réinitialiser les paramètres

Préférences › General › Back up, restore and reset exporte les paramètres de votre application, vos profils et vos paramètres git vers un fichier, importe un tel fichier ou réinitialise tout. Une exportation ne contient jamais de mots de passe, de jetons ou de détails de compte, ni de paramètres de référentiel. Les paramètres Git d'une importation sont écrits dans ~/.gitconfig uniquement après que vous les ayez examinés.

Rechercher et installer les mises à jour

GitTree ne trouve pas Git

GitTree utilise votre propre installation Git et n'en regroupe ni n'installe jamais. Si aucun n'est trouvé, il affiche GitTree needs Git ; si celui trouvé est plus ancien que 2,39, il affiche This Git is too old. Installez ou mettez à jour Git, ou appuyez sur Locate Git… pour le choisir, puis sur Check again.

Un référentiel ne s'ouvrira pas

Lorsqu'un dossier ne peut pas être ouvert, GitTree explique pourquoi et propose l'étape suivante : This folder is not a Git repository (initialiser ou en choisir un autre), This cannot be opened as a repository (chemin manquant), GitTree cannot read this folder (autorisations) ou This repository belongs to another user (vérification de propriété par Git).

Les changements ne sont pas rafraîchissants

GitTree remarque les modifications apportées dans d'autres programmes via les notifications de modification de votre système. Sur les dossiers WSL et les partages réseau, ces notifications n'arrivent pas, donc Automatic vérifie le dossier toutes les quelques secondes. Si les modifications apparaissent encore tardivement, forcez le mode de vérification pour ce référentiel ou actualisez manuellement.

Une tentative d'authentification à distance a échoué

Git signs in to a remote with your own credential helper or SSH key first. … needs you to sign in. signifie que rien n'a été répondu ; … refused the credentials sent for this repository. means what was sent is no longer valid or not allowed. Corrigez les informations d'identification utilisées par Git ; a connected account fills in only when your helpers have nothing, or when you choose it for a repository.

Une poussée a été rejetée

Un push est refusé pour l'une des trois raisons suivantes, et GitTree indique laquelle. The remote refused … : la télécommande a des commits que votre branche n'a pas. The remote declined the push : une protection hook ou branche a dit non, avec sa raison. … moved : une poussée forcée avec bail a trouvé que la télécommande n'était plus là où vous l'aviez récupérée pour la dernière fois, donc rien n'a été remplacé.

Une opération Git nécessite une attention particulière

Lorsqu'une fusion, un rebase, une sélection sélective, un retour ou une coupe en deux s'arrête à mi-chemin, GitTree affiche une bannière telle que Rebasing … onto …, step 3 of 7 et marque l'onglet rebase in progress. La plupart des commandes attendent la fin : résolvez les conflits, puis Continue, Skip l'étape ou Abort… pour revenir à votre point de départ.

Une action d'intégration n'est pas disponible

Lorsqu'une action d'hébergement ne peut pas être utilisée, GitTree indique pourquoi au lieu d'échouer silencieusement. Les raisons habituelles sont : il fait partie de GitTree Pro ; aucun compte n'est connecté pour l'hôte de la télécommande ; le jeton doit être reconnecté ; votre rôle chez le prestataire ne le permet pas ; le fournisseur ne le propose pas ; ou le fournisseur limite les demandes pendant un certain temps.

Nour ne peut pas commencer ou terminer

Nour exécute une CLI d'agent de codage sur votre ordinateur, donc la plupart des problèmes sont liés à la CLI : non installé, non connecté, aucune utilisation restante, le modèle que vous avez défini n'est pas disponible ou il nécessite Node.js. GitTree refuse également de démarrer un tour dans un référentiel restreint, ou lorsqu'il ne peut pas enregistrer l'instantané qui rend le tour annulé.

Un pipeline ou un journal ne peut pas être chargé

GitTree indique pourquoi une exécution ou un journal est manquant : 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., ou que le fournisseur limite les requêtes. La plupart ont une solution ; certains ouvrent uniquement la page du fournisseur.

Un trousseau de clés ou une requête SSH a échoué

GitTree conserve les jetons de compte, sa connexion et les phrases secrètes SSH mémorisées uniquement dans le trousseau de votre système : le macOS Keychain, le Windows Credential Manager ou le Secret Service (GNOME Keyring ou KeePassXC) sur Linux. Lorsque le trousseau dit non, GitTree vous demande d'autoriser l'accès et de réessayer ; il ne revient jamais à un fichier.

Utiliser GitTree en mode hors connexion

GitTree est d'abord local : chaque fonctionnalité Git locale fonctionne sans connexion, y compris les validations, les branches, les fusions, les rebases, les caches, l'historique et les annulations. Récupérer, extraire, pousser, intégrations d'hébergement, CI/CD et le fournisseur de Nour ont besoin du réseau ; en mode hors connexion, GitTree affiche les dernières données lues et l'indique.

Collecter et partager un rapport de support

Lorsque GitTree détecte une erreur, il enregistre un rapport sur cet ordinateur ; rien n'est envoyé nulle part. Report a Bug… affiche ce qui serait copié (le rapport enregistré avec les jetons et les mots de passe supprimés, ou un bref résumé), vous permet de choisir, puis ouvre le formulaire d'assistance sur le site Web GitTree pour que vous puissiez le coller. Contact Support… écrit à l'adresse d'assistance.