Skip to main content

Verwenden von GitHub CLI-Erweiterungen

Hier erfährst du, wie du benutzerdefinierte Erweiterungen verwenden kannst, die von anderen GitHub CLI-Benutzern geschrieben wurden.

Informationen zu GitHub CLI-Erweiterungen

Hinweis: Erweiterungen außerhalb von GitHub Enterprise Server und GitHub CLI sind nicht von GitHub Enterprise Server zertifiziert und werden durch separate Nutzungsbedingungen, Datenschutzrichtlinien und Supportdokumentation geregelt. Um das Risiko bei der Verwendung von Drittanbietererweiterungen zu minimieren, überprüfe den Quellcode der Erweiterung, bevor du die Erweiterung installierst oder aktualisierst.

GitHub CLI-Erweiterungen sind benutzerdefinierte GitHub CLI-Befehle, die jeder erstellen und verwenden kann. Weitere Informationen zum Erstellen von GitHub CLI-Erweiterungen findest du unter Erstellen von GitHub CLI-Erweiterungen.

Erweiterungen werden lokal installiert und sind auf den Benutzer beschränkt. Wenn du also von einem anderen Computer aus auf GitHub CLI zugreifst oder ein anderer Benutzer von deinem Computer aus auf GitHub CLI zugreift, ist die Erweiterung nicht verfügbar.

Suchen nach Erweiterungen

Du findest Erweiterungen, indem du Repositorys mit dem gh-extension-Thema durchsuchst.

Installieren von Erweiterungen

Um eine Erweiterung zu installieren, verwende den extensions install-Unterbefehl. Ersetze den repo-Parameter durch das Repository der Erweiterung. Du kannst die vollständige URL wie z. B. https://github.com/octocat/gh-whoami verwenden, oder einfach den Besitzer und das Repository, z. B. octocat/gh-whoami.

Wenn der Besitzer und das Repository verwendet werden, installiert gh die Erweiterung mithilfe des Hostnamens, bei dem gh derzeit authentifiziert ist. Das vollständige URL-Format ist nützlich, wenn Erweiterungen von einem anderen Host aus installiert werden. Benutzer in GitHub Enterprise Server sollten beispielsweise die vollständige Repository-URL verwenden, um Erweiterungen von GitHub.com oder einem anderen Host aus zu installieren.

Verwende zum Installieren einer Erweiterung in der Entwicklung aus dem aktuellen Verzeichnis . als Wert für den repo-Parameter.

gh extension install REPO

Wenn du bereits eine Erweiterung mit demselben Namen installiert hast, ist der Befehl nicht erfolgreich ausführbar. Wenn du z. B. octocat/gh-whoami installiert hast, musst du dies deinstallieren, bevor du hubot/gh-whoami installierst.

Ausführen einer Erweiterung

Wenn Sie eine Erweiterung installiert haben, führen Sie die Erweiterung wie einen nativen GitHub CLI-Befehl mit gh EXTENSION-NAME aus. Das EXTENSION-NAME ist der Name des Repositorys, das die Erweiterung enthält, abzüglich des Präfixes gh-.

Wenn Sie beispielsweise die Erweiterung aus dem octocat/gh-whoami-Repository installiert haben, führen Sie die Erweiterung mit dem folgenden Befehl aus.

gh whoami

In der Regel finden Sie spezifische Informationen zur Verwendung einer Erweiterung in der Infodatei des Repositorys, das die Erweiterung enthält.

Anzeigen installierter Erweiterungen

Um alle installierten Erweiterungen anzuzeigen, verwende den extensions list-Unterbefehl. Die Ausgabe teilt dir auch mit, für welche Erweiterungen Updates verfügbar sind.

gh extension list

Aktualisieren von Erweiterungen

Um eine Erweiterung zu aktualisieren, verwende den extensions upgrade-Unterbefehl. Ersetze den extension-Parameter durch den Namen der Erweiterung.

gh extension upgrade EXTENSION

Um alle installierten Erweiterungen zu aktualisieren, verwende das --all-Flag.

gh extension upgrade --all

Deinstallieren von Erweiterungen

Um eine Erweiterung zu deinstallieren, verwende den extensions remove-Unterbefehl. Ersetze den extension-Parameter durch den Namen der Erweiterung.

gh extension remove EXTENSION