Introduction

yaggui est un client Git graphique pour macOS, Windows et Linux. Il s’exécute sur votre ordinateur, s’appuie sur votre propre installation de git et affiche chaque commande Git qu’il lance. Cette page résume ce que yaggui fait, ce qu’il laisse de côté, et comment lire le reste de la documentation.

Comment fonctionne yaggui

• Votre propre Git. yaggui lit directement les dépôts pour aller vite, et lance la commande git installée sur votre système pour chaque modification qu’il effectue. Vos hooks, votre configuration, votre credential helper et votre ssh-agent s’appliquent, comme dans un terminal. Il faut Git 2.30 ou plus récent ; voir Installer yaggui.
• Pas de compte, pas de télémétrie. yaggui ne vous demande jamais de vous connecter et n’envoie aucune donnée d’usage.
• Le réseau seulement quand vous le demandez. yaggui contacte un serveur pour les opérations Git (clone, fetch, pull, push, fetch automatique) et pour deux fonctions désactivées tant que vous ne les activez pas :
  • Avatars Gravatar : un hash de l’e-mail de chaque auteur est envoyé à gravatar.com. Voir Préférences.
  • Vérification des mises à jour : yaggui consulte la dernière release sur github.com au lancement. Voir Mises à jour.
• Aucun secret stocké. yaggui ne demande ni ne stocke jamais de mot de passe ou de jeton. Les identifiants viennent de votre credential helper Git ou de ssh-agent ; voir Authentification.

Ce que yaggui conserve sur le disque (dépôts récents, onglets, préférences) est détaillé dans Données et confidentialité.

Ce que fait yaggui

Domaine	Ce que vous pouvez faire	Pour commencer
Premiers pas	Installer, ouvrir, cloner ou initialiser un dépôt, se repérer dans la fenêtre	Ouvrir un dépôt, Visite de la fenêtre
Travail quotidien	Indexer des fichiers, des blocs ou des lignes isolées, commiter et amender, mettre en stash, lire des diffs	Indexation, Commits, Stash, Diff
Historique	Parcourir le graphe des commits, gérer les branches et les tags, merge, rebase, cherry-pick, revert, reset, rebase interactif, résolution de conflits, annulation	Graphe des commits, Branches, Annuler et rétablir
Remotes	Fetch, pull et push, gérer les remotes, configurer les identifiants	Fetch, pull et push, Remotes, Authentification
Inspection	Comparer des branches, lire l’historique et le blame d’un fichier, parcourir le reflog	Comparer, Historique et blame d’un fichier, Reflog
Dépôt	Sous-modules, worktrees, Git LFS, terminal intégré	Sous-modules, Worktrees, Git LFS, Terminal
Workspaces	Travailler sur plusieurs dépôts dans des onglets, les regrouper en workspaces	Onglets, Workspaces
Personnalisation	Thèmes, langue, raccourcis, outils externes, configuration de Git	Apparence, Palette et raccourcis, Outils externes, Configuration de Git
Référence et entraide	Chaque raccourci, réglage et message d’erreur ; dépannage	Référence, Dépannage, FAQ

Ce que yaggui ne fait pas

Ces fonctions sont hors du périmètre de yaggui :

• L’intégration aux services d’hébergement : ni pull requests, ni tickets, ni revues depuis GitHub, GitLab ou Azure DevOps.
• La synchronisation des préférences par un service cloud.
• Les messages de commit générés par IA.
• La création ou la gestion de clés GPG et SSH. yaggui utilise les clés que vous avez déjà.
• Les systèmes de gestion de versions autres que Git.

Celles-ci ne sont pas disponibles dans la version actuelle :

• Les dépôts nus. En ouvrir un affiche « Les dépôts nus ne sont pas encore pris en charge. »
• Plusieurs fenêtres. Chaque dépôt s’ouvre dans un onglet de la même fenêtre.
• Le lancement d’un bisect. Un bisect lancé dans un terminal est détecté, et vous pouvez passer un commit ou l’arrêter depuis la bannière d’opération ; voir Conflits.
• La création ou l’application de patchs. Un git am lancé dans un terminal est détecté et peut être continué, passé ou annulé depuis yaggui.
• Une vue du graphe en first-parent, et l’historique d’une plage de lignes (git log -L).
• Les commits fixup depuis le graphe (l’entrée de menu Créer un commit fixup… est affichée comme prévue), les trailers de co-auteur, et l’application d’un seul fichier d’un stash.
• L’ajout, la suppression ou la synchronisation de sous-modules ; voir Sous-modules pour ce qui est disponible.
• Les notifications système à la fin d’une longue opération en arrière-plan.
• L’import ou l’export des préférences.
• Une boîte de dialogue pour saisir un mot de passe ou un jeton quand l’authentification échoue. Configurez plutôt un credential helper ou ssh-agent.

Comment lire cette documentation

Raccourcis clavier

Les raccourcis sont écrits d’abord pour macOS, puis pour Windows et Linux quand ils diffèrent : ⌘K (Ctrl+K sous Windows et Linux). Quand un raccourci utilise la touche Contrôle sur tous les systèmes, il n’est écrit qu’une fois, par exemple Ctrl+Tab.

Chaque raccourci de cette documentation est un raccourci par défaut. Vous pouvez tous les modifier ; voir Palette et raccourcis. La liste complète est dans Raccourcis clavier, et ⌘/ (Ctrl+/ sous Windows et Linux) l’affiche dans l’application.

La plupart des actions figurent aussi dans la palette de commandes : appuyez sur ⌘K (Ctrl+K sous Windows et Linux) et tapez quelques lettres de l’action.

Annulation

De nombreuses opérations locales peuvent être annulées avec Annuler dans la barre d’outils ou ⌘Z (Ctrl+Z sous Windows et Linux) : commits, checkouts, resets, abandons de modifications, changements de branche, etc. Chaque page indique si ses actions sont annulables. Ce qui peut ou non être annulé, et pendant combien de temps, est expliqué dans Annuler et rétablir.

Le journal des commandes

yaggui enregistre chaque commande Git qu’il lance, avec sa sortie, son code de sortie et sa durée. Ouvrez le journal avec ⌘J (Ctrl+J sous Windows et Linux) ou avec le bouton Journal (il affiche le nombre de commandes, comme dans Journal (12)) à droite de la barre d’état. Quand cette documentation montre la commande lancée par une action, vous pouvez la vérifier dans le journal. Voir Journal des commandes.

Messages d’erreur

Quand une commande Git échoue, yaggui affiche un message en langage clair, la sortie brute de Git sous Détails et, quand il le peut, un bouton qui corrige ou explique le problème. Chaque message est listé dans Messages d’erreur.