gh-stack : gérer des PR empilées avec GitHub CLI

À qui ça s'adresse

gh-stack est une extension GitHub CLI pour gérer des branches empilées et des Pull Requests. Elle convient à qui utilise déjà GitHub CLI et doit faire avancer un ensemble ordonné de branches comme une stack. Le résumé indique aussi que l'installation de l'extension exige GitHub CLI v2.0+.

Le matériau mentionne qu'on peut installer le gh-stack skill pour qu'un agent de codage IA comprenne les PR empilées et la ligne de commande gh stack ; l'extrait dit seulement « installer ce skill » et ne donne pas de deuxième commande d'installation, donc n'inventez pas un installeur qui n'apparaît pas. Aucune liste de produits d'agent n'est donnée ; ne le traitez pas comme une fonction exclusive à un éditeur. La page officielle du guide est

https://github.com/github/gh-stack

Premier essai en 3 minutes

La commande d'installation officielle est celle-ci, tirée de l'extrait :

gh extension install github/gh-stack

Prérequis : GitHub CLI est déjà sur la machine, et la version satisfait le v2.0+ du résumé. Cette commande écrit une extension sur la machine : elle a des effets de bord. Confirmez que le dépôt et le compte courants sont l'environnement où vous voulez tester la stack, puis installez.

Vérification à bas risque après installation : ne créez pas tout de suite une branche. Confirmez d'abord que la commande gh stack est déjà trouvable par le CLI. Le matériau explique gh stack init comme « commencer une nouvelle stack, et créer puis extraire la première branche » ; cela change l'arbre de travail, donc obtenez confirmation avant d'exécuter :

gh stack init

Signal de succès : après installation, gh reconnaît la sous-commande stack. Si vous avez confirmé vouloir une nouvelle stack, après init le dépôt courant a la nouvelle première branche, et vous pourrez plus tard voir des métadonnées JSON dans .git/gh-stack (non commité). Si vous voulez d'abord seulement lire le guide, arrêtez-vous après une installation réussie et n'initiez pas.

Cas d'usage

Cas 1 : commencer une nouvelle branche empilée. Dans un dépôt où l'extension est installée, confirmez que vous pouvez changer de branche, puis exécutez gh stack init. Le matériau le décrit comme créer et extraire la première branche. Le résumé évoque ensuite d'ajouter des couches, pousser, consulter, puis soumettre un ensemble de PR, mais l'extrait ne donne pas l'écriture complète de ces sous-commandes suivantes. Le critère de fin de ce cas s'arrête à « la première branche est créée et extraite » ; n'écrivez pas le push ou l'ouverture d'une PR comme des étapes déjà copiables.

Cas 2 : vérifier où atterrissent les métadonnées de stack, pour savoir quoi regarder après un rebase interrompu. Le matériau indique : les métadonnées de stack sont dans .git/gh-stack, un JSON non commité dans le dépôt, qui enregistre quelles branches appartiennent à quelle stack et dans quel ordre ; l'état d'un rebase interrompu est stocké à part dans .git/gh-stack-rebase-state. C'est une vérification en lecture seule : ouvrez ces deux chemins, confirmez l'existence des fichiers et que le JSON suit l'ordre actuel des branches. Ne les éditez pas à la main sauf si la même page donne d'autres étapes ; l'extrait ne donne pas de format d'édition.

Limites d'usage

L'extension ne couvre que la gestion des branches empilées et des Pull Requests. Les métadonnées sont dans .git/gh-stack et n'entrent pas dans l'arbre versionné ; l'état de rebase interrompu est dans .git/gh-stack-rebase-state. init crée et extrait une branche ; ce n'est pas une commande en lecture seule.

N'inventez pas une commande d'installation de skill absente de l'extrait, et ne traitez pas l'ajout de couches, le push, la consultation ou la soumission du résumé comme une liste de sous-commandes déjà donnée. Le matériau ne nomme pas de clients et ne dit pas comment s'en servir hors de GitHub CLI. Au-delà de ces emplacements d'installation, d'init et de métadonnées déjà écrits, ce guide ne couvre rien.