gh-stack: gestapelte PRs mit GitHub CLI verwalten

Für wen

gh-stack ist eine GitHub-CLI-Erweiterung zum Verwalten gestapelter Branches und Pull Requests. Sie passt zu Leuten, die GitHub CLI schon nutzen und eine geordnete Gruppe von Branches als einen stack voranbringen wollen. Die Zusammenfassung sagt außerdem, dass die Installation GitHub CLI v2.0+ braucht.

Das Material erwähnt, man könne das gh-stack skill installieren, damit ein KI-Coding-Agent gestapelte PRs und die gh stack-Kommandozeile versteht. Der Auszug schreibt nur „dieses skill installieren“ und gibt keinen zweiten Installationsbefehl; erfinde also keinen Installer, der nie vorkommt. Es gibt keine Liste von Agentenprodukten; behandle das nicht als Exklusivfunktion eines Editors. Die offizielle Anleitungsseite ist

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

Ersten Versuch in 3 Minuten abschließen

Der offizielle Installationsbefehl ist genau dieser aus dem Auszug:

gh extension install github/gh-stack

Voraussetzung: GitHub CLI ist bereits auf dem Rechner, und die Version erfüllt das in der Zusammenfassung genannte v2.0+. Der Befehl schreibt eine Erweiterung auf die Maschine und hat Nebenwirkungen. Bestätige zuerst, dass aktuelles Repository und Konto die Umgebung sind, in der du den stack ausprobieren willst, dann installieren.

Risikoarme Prüfung nach der Installation: nicht sofort einen Branch anlegen. Zuerst prüfen, dass der Befehl gh stack von der CLI gefunden wird. Das Material erklärt gh stack init als „einen neuen stack starten und den ersten Branch erstellen und auschecken“; das ändert den Arbeitsbaum, also erst bestätigen lassen, dann ausführen:

gh stack init

Erfolgssignal: nach der Installation erkennt gh den stack-Unterbefehl. Wenn du bestätigt hast, einen neuen stack zu starten, erscheint nach init im aktuellen Repository der neue erste Branch, und später siehst du JSON-Metadaten in der uncommitteten .git/gh-stack. Willst du zuerst nur die Anleitung lesen, nach erfolgreicher Installation stehen bleiben und nicht init ausführen.

Anwendungsfälle

Fall 1: Einen neuen gestapelten Branch beginnen. Im Repository mit installierter Erweiterung bestätigen, dass Branches geändert werden dürfen, dann gh stack init ausführen. Das Material schreibt das als Erstellen und Auschecken des ersten Branch. Die Zusammenfassung erwähnt danach Schichten hinzufügen, pushen, ansehen und eine Gruppe PRs einreichen, aber der Auszug gibt keine vollständigen Schreibweisen dieser späteren Unterbefehle. Fertig ist dieser Fall nur bei „erster Branch erstellt und ausgecheckt“; Push oder PR-Öffnen nicht als bereits kopierbare Schritte schreiben.

Fall 2: Prüfen, wo stack-Metadaten landen, um nach einem unterbrochenen rebase zu wissen, wo man hinschaut. Das Material sagt: stack-Metadaten liegen in .git/gh-stack, einer JSON-Datei, die nicht ins Repository committet wird und festhält, welche Branches zu welchem stack gehören und in welcher Reihenfolge; der Zustand eines unterbrochenen rebase liegt separat in .git/gh-stack-rebase-state. Das ist eine schreibgeschützte Prüfung: beide Pfade öffnen, Existenz der Dateien und ob die JSON die aktuelle Branch-Reihenfolge verfolgt prüfen. Diese Dateien nicht von Hand ändern, außer dieselbe Seite gibt andere Schritte; der Auszug nennt kein Bearbeitungsformat.

Nutzungsgrenzen

Die Erweiterung deckt nur die Verwaltung gestapelter Branches und Pull Requests ab. Metadaten liegen in .git/gh-stack und kommen nicht in den Versionsbaum; der unterbrochene-rebase-Zustand liegt in .git/gh-stack-rebase-state. init erstellt und checkt einen Branch aus; das ist kein Nur-Lese-Befehl.

Erfinde keinen skill-Installationsbefehl, der im Auszug nicht vorkommt, und behandle Schichten hinzufügen, Push, Ansehen und Einreichen aus der Zusammenfassung nicht als bereits gegebene Unterbefehlsliste. Das Material nennt keine Clients und nicht, wie man das außerhalb von GitHub CLI nutzt. Jenseits dieser geschriebenen Installation, init und Metadatenorte deckt diese Anleitung nichts ab.