Palette de commandes et raccourcis

La palette de commandes réunit, dans un seul champ de recherche, toutes les actions de yaggui ainsi que les branches, les tags, les commits, les fichiers modifiés et les onglets de la fenêtre. Chaque action et la plupart des touches globales ont un identifiant stable et un raccourci que vous pouvez changer.

Ouvrir la palette de commandes

Appuyez sur ⌘K (Ctrl+K sous Windows et Linux). Le même raccourci la referme, tout comme Esc et un clic à l’extérieur. Elle fonctionne partout, y compris depuis le terminal intégré.

Tapez pour filtrer. La recherche est approximative : fpu trouve Force push (avec lease). Utilisez ↑ et ↓ pour vous déplacer (la liste est circulaire), Home et End lorsque le champ est vide, et Enter pour lancer l’entrée en surbrillance. Le pied de la palette indique le nombre de résultats.

Ce que la palette recherche

Type	Ce que vous obtenez	Effet de Enter
Action	Toutes les commandes de yaggui : ouvrir, cloner, fetch, push, créer une branche, afficher ou masquer des panneaux, ouvrir les préférences…	La lance
Branche	Les branches locales et distantes du dépôt actif	Sélectionne son commit dans le graphe et l’ajoute aux branches récentes. Elle n’est pas extraite (checkout)
Tag	Les tags, avec le message du tag en détail	Sélectionne son commit dans le graphe
Commit	Les commits dont le message, l’auteur ou le début du SHA correspond, avec <SHA court> · <auteur> en détail	Sélectionne le commit dans le graphe
Fichier	Les fichiers du commit sélectionné dans le graphe ou, sans sélection, vos changements indexés et non indexés (détail indexé ou copie de travail)	Ouvre le diff du fichier
Onglet	Les autres onglets de la fenêtre	Bascule vers cet onglet

La recherche de fichiers ne couvre pas tous les fichiers du dépôt, seulement les fichiers modifiés décrits ci-dessus. La recherche de commits s’exécute en arrière-plan et démarre dès que la requête compte 2 caractères ; « Recherche… » s’affiche pendant son exécution, et 12 commits au plus sont listés. 50 résultats au maximum s’affichent à la fois.

Les actions qui ne peuvent pas s’exécuter pour le moment (aucun dépôt ouvert, aucun commit sélectionné, aucune opération en cours…) restent listées, grisées, avec le détail « Bientôt disponible », et ne font rien.

Restreindre la recherche avec un préfixe

Commencez la requête par l’un de ces caractères pour ne chercher qu’un seul type. Le pied de la palette les rappelle.

Préfixe	Recherche
>	Les actions uniquement
@	Les branches et les tags
#	Les commits (dès le premier caractère)
/	Les fichiers modifiés

Sans préfixe, tous les types sont recherchés, et les onglets n’apparaissent que dans ce mode.

Récents et ordre

Avec une requête vide, vos 8 dernières entrées lancées arrivent en tête, puis les actions regroupées en Dépôt, Onglets, Affichage, Application et Git, puis les onglets, les branches et les tags, et enfin les fichiers. Les récents ne sont conservés que sur cet ordinateur. Quand vous tapez, les meilleures correspondances passent en premier ; les récents et la branche courante bénéficient d’un léger bonus, et les actions désactivées descendent en bas de liste.

Les raccourcis dans les résultats

Une action qui a un raccourci l’affiche à droite de sa ligne, avec votre raccourci actuel. Les autres lignes y affichent leur type : Action, Branche, Tag, Commit, Fichier ou Onglet.

Voir tous les raccourcis

Appuyez sur ⌘/ (Ctrl+/ sous Windows et Linux) ou lancez Afficher les raccourcis clavier pour ouvrir l’aide-mémoire Raccourcis clavier. Elle liste chaque commande associée à un raccourci, avec votre raccourci actuel, regroupées en Dépôt, Onglets, Affichage, Application, Git et Graphe. Modifier les raccourcis… ouvre les préférences sur l’onglet Raccourcis.

Sous macOS, les raccourcis utilisent les symboles ⌘ ⌃ ⌥ ⇧ ↵ ; sous Windows et Linux, ils s’écrivent Ctrl, Alt, Shift, Enter.

Note

Sur les dispositions de clavier où / demande Shift (AZERTY, par exemple), le raccourci par défaut ⌘/ ne se déclenche pas. Modifiez le raccourci de Afficher les raccourcis clavier ou passez par la palette. Les lettres et les chiffres sont reconnus par leur position physique sur le clavier, ils fonctionnent donc avec toutes les dispositions.

La liste complète des raccourcis par défaut figure dans la référence des raccourcis clavier.

Modifier un raccourci

1. Ouvrez Préférences › Raccourcis (ou cliquez sur Modifier les raccourcis… dans l’aide-mémoire).
2. Repérez la commande. Filtrer les commandes ou les raccourcis compare votre saisie au libellé, à l’identifiant de l’action et au texte du raccourci.
3. Cliquez sur Modifier sur sa ligne. Le bouton affiche « Tape le raccourci… (Échap pour annuler) ».
4. Appuyez sur la nouvelle combinaison. Si vous n’appuyez que sur des modificateurs, l’attente continue ; Esc ou un clic ailleurs annule.

Le raccourci est enregistré immédiatement et s’applique partout : indications de la palette, aide-mémoire, info-bulles et, sous macOS, barre de menus.

Règles pour un raccourci

• Il faut au moins une des touches ⌘, Ctrl ou Alt (⌥), plus une touche. Shift seule ne compte pas. Les touches de fonction F1 à F12 font exception : elles peuvent être utilisées seules.
• La touche Windows ne peut pas être utilisée sous Windows et Linux.
• Sinon, le message « Utilise un modificateur (⌘, Ctrl, Alt) avec une touche, ou une touche de fonction. » s’affiche et la capture attend une autre combinaison.
• Sous macOS, ⌘ et ⌃ sont distinctes. Sous Windows et Linux, Ctrl joue le rôle de ⌘.
• yaggui ne détecte pas les raccourcis réservés par votre OS ou votre gestionnaire de fenêtres. Si un raccourci n’atteint jamais yaggui, choisissez-en un autre.

Résoudre un conflit

Si la combinaison appartient déjà à une autre commande, la ligne affiche « Déjà utilisé par : commande » avec deux boutons :

• Réassigner donne le raccourci à cette commande et le retire à l’autre, en un seul enregistrement.
• Annuler conserve tout comme avant.

Les conflits issus d’un fichier modifié à la main apparaissent sur chaque ligne concernée sous la forme « Même raccourci que : commande ».

Retirer ou réinitialiser des raccourcis

• Retirer laisse la commande sans raccourci (« Aucun raccourci »). Elle reste disponible dans la palette.
• Défaut rétablit le raccourci par défaut de la commande. Le bouton n’est actif que pour les commandes que vous avez modifiées ; les raccourcis modifiés sont mis en évidence.
• Tout remettre par défaut, dans la barre d’outils, annule toutes vos modifications.

Modifier keybindings.json

Vos modifications sont stockées dans keybindings.json, dans le dossier de configuration de yaggui (voir Données et confidentialité). Le chemin complet s’affiche sous Enregistré dans, en bas de l’onglet Raccourcis. Le fichier ne contient que ce qui diffère des valeurs par défaut :

{
  "git.push": "Mod+Alt+P",
  "graph.copyMessage": null,
  "view.log": "F2"
}

• Les clés sont des identifiants d’action. L’onglet Raccourcis les affiche lorsque vous filtrez, et la référence les liste tous.
• Une chaîne définit le raccourci ; null le retire ; un identifiant absent conserve la valeur par défaut.
• Syntaxe d’un raccourci : des modificateurs parmi Mod, Ctrl, Alt et Shift, chacun au plus une fois, puis une touche, le tout relié par +. Mod est ⌘ sous macOS et Ctrl sous Windows et Linux ; Ctrl est la touche Contrôle physique partout. Touches possibles : A à Z, les chiffres, F1 à F12, Space, Enter, Escape, Tab, ArrowLeft, ArrowRight, ArrowUp, ArrowDown, `, et la ponctuation comme , et /.

yaggui lit le fichier au démarrage, puis à chaque ouverture de l’onglet Raccourcis : vos modifications manuelles y prennent donc effet sans redémarrage. Quand yaggui enregistre un changement, il réécrit le fichier en entier (trié, mis en forme).

Si le fichier est illisible ou n’est pas du JSON valide, yaggui utilise les raccourcis par défaut et l’onglet Raccourcis affiche un bandeau « keybindings.json pose problème : détail ». Si seules certaines entrées sont erronées, les autres s’appliquent et le bandeau affiche « Ignored entries: ids ». yaggui ne touche pas au fichier tant que vous ne modifiez pas un raccourci dans l’onglet ; à ce moment-là, il est réécrit avec les raccourcis que l’onglet affiche, ce qui supprime le contenu invalide.

Attention

Si le bandeau signale une erreur d’analyse, corrigez le fichier à la main avant de modifier un raccourci dans l’onglet, faute de quoi les personnalisations que yaggui n’a pas pu lire seront perdues.

Touches non modifiables

Certaines touches n’ont de sens que dans un panneau précis et sont fixes :

Où	Touches
Graphe (avec le focus)	↑ ↓ pour se déplacer, avec Shift pour étendre la sélection ; Page Up Page Down ; Home End ; Shift+F10 ou la touche Menu pour le menu contextuel ; Esc
Vue diff	n / p bloc suivant ou précédent ; j / k fichier suivant ou précédent ; ⌘D (Ctrl+D) côte à côte ou unifié ; Esc efface la sélection de lignes, puis ferme le diff
Lignes du diff	↑ ↓ (avec Shift pour étendre) ; Space sélectionne une ligne ; Enter indexe (désindexe dans le diff des changements indexés) ; Backspace ou Delete annule les lignes sélectionnées
Fichiers modifiés	↑ ↓ sélectionnent et ouvrent le diff (avec Shift pour étendre) ; Space indexe ou désindexe
Panneau des refs	Touches fléchées, Home End, Page Up Page Down, Enter ou Space pour activer, saisie des premières lettres pour se placer, ⌘C (Ctrl+C) copie le nom de la ref
Barre d’onglets	← → onglet précédent ou suivant, Home End, Delete ferme l’onglet qui a le focus
Vue des conflits	⌥↓ / ⌥↑ (Alt+↓ / Alt+↑) conflit suivant ou précédent, ⌘S (Ctrl+S) enregistre
Rebase interactif	⌥↑ / ⌥↓ déplace un commit ; p r s f d e définissent l’action

La liste complète figure dans la référence des raccourcis clavier.

Comportement des raccourcis

• Tant qu’une boîte de dialogue est ouverte, les raccourcis globaux et les commandes de menu sont ignorés. Le raccourci de la palette continue de la fermer.
• Dans un champ de texte, ⌘Z et ⌘⇧Z (Ctrl+Z, Ctrl+Shift+Z, Ctrl+Y) annulent et rétablissent la saisie, et non la dernière opération Git. Voir Annuler et rétablir.
• Quand le terminal intégré a le focus, il reçoit toutes les touches, sauf le raccourci de la palette et les deux raccourcis du terminal (⌃</kbd> et <kbd>⌃⇧, qui utilisent Contrôle aussi sous macOS).
• Un raccourci dont l’action ne peut pas s’exécuter ne fait rien. Annuler et rétablir font exception : ils expliquent pourquoi rien ne peut être annulé.
• ⌘C et ⌘⇧C (Ctrl+C, Ctrl+Shift+C) copient le SHA ou le message des commits sélectionnés uniquement quand le graphe a le focus.

Naviguer au clavier

Chaque contrôle affiche un anneau de focus visible. Tab et Shift+Tab font passer de la barre d’outils au panneau des refs, au graphe, au panneau de détails et aux listes de changements ; les touches fléchées se déplacent ensuite dans la liste ou l’arbre qui a le focus. Quelques raccourcis globaux mènent directement à un endroit :

Raccourci	Mène à
⌘K (Ctrl+K)	La palette de commandes
⌘F (Ctrl+F)	La recherche dans le graphe
⌘⇧H (Ctrl+Shift+H)	HEAD dans le graphe
⌘⇧R (Ctrl+Shift+R)	Le champ de filtre du panneau des refs
⌘⌥B / ⌘⌥I (Ctrl+Alt+B / Ctrl+Alt+I)	Afficher ou masquer le panneau des refs ou de détails
⌘1 à ⌘9 (Ctrl+1 à Ctrl+9)	L’onglet 1 à 9
⌃Tab / ⌃⇧Tab (Ctrl+Tab / Ctrl+Shift+Tab)	L’onglet suivant ou précédent

Les séparateurs de panneaux peuvent recevoir le focus et se déplacer avec les touches fléchées.