关于 GitHub CLI 扩展

GitHub 和 GitHub CLI 之外的扩展未经 GitHub 认证,并受单独的服务条款、隐私政策和支持文档的约束。为了降低使用第三方扩展时的风险,请在安装或更新扩展之前审核扩展的源代码。

GitHub CLI 扩展 有关如何创建 GitHub CLI 扩展的更多信息,请参阅 _”AUTOTITLE.”

扩展在本地安装并且仅限于用户。因此,如果您从不同的计算机访问 GitHub CLI,或者其他用户从同一台计算机访问 GitHub CLI,则该扩展将不可用。_

寻找扩展

您可以通过浏览具有 gh-extension 主题的存储库来查找扩展。

安装扩展

要安装扩展,请使用 extensions install 子命令。将 repo 参数替换为扩展的存储库。您可以使用完整的 URL,例如https://github.com/octocat/gh-whoami,也可以仅使用所有者和存储库,例如 octocat/gh-whoami

如果使用所有者和存储库,gh 将使用 gh 当前经过身份验证的主机名安装扩展。从不同主机安装扩展时,完整 URL 格式非常有用。例如,GitHub Enterprise Server 上的用户应使用完整的存储库 URL 从 GitHub.com 或任何其他主机安装扩展。

要从当前目录安装开发中的扩展,请使用 . 作为 repo 参数的值。

  1. gh extension install REPO

如果您已经安装了同名的扩展,该命令将失败。例如,如果您已经安装了 octocat/gh-whoami,则必须在安装 hubot/gh-whoami 之前将其卸载。

运行扩展

安装扩展后,您可以使用 gh EXTENSION-NAME 运行该扩展,就像运行本机 GitHub CLI 命令一样。 EXTENSION-NAME 是包含扩展的存储库的名称,减去 gh- 前缀。

例如,如果您从 octocat/gh-whoami 存储库安装了扩展,则可以使用以下命令运行该扩展。

  1. gh whoami

您通常可以在包含扩展的存储库的自述文件中找到有关如何使用扩展的具体信息。

查看已安装的扩展

要查看所有已安装的扩展,请使用 extensions list 子命令。输出还将告诉您哪些扩展有可用的更新。

  1. gh extension list

更新扩展

要更新扩展,请使用 extensions upgrade 子命令。将 extension 参数替换为扩展名。

  1. gh extension upgrade EXTENSION

要更新所有已安装的扩展,请使用 --all 标志。

  1. gh extension upgrade --all

卸载扩展

要卸载扩展,请使用 extensions remove 子命令。将 extension 参数替换为扩展名。

  1. gh extension remove EXTENSION