Acerca de las extensiones del CLI de GitHub
Nota: Las extensiones fuera de GitHub Enterprise Server y CLI de GitHub no están certificadas por GitHub Enterprise Server y se rigen por términos de servicio, políticas de privacidad y documentación de soporte distintas. Para mitigar el riesgo al utilizar extensiones de terceros, audita el código fuente de la extensión antes de instalarla o actualizarla.
Las extensiones del CLI de GitHub son comandos personalizados del CLI de GitHub que cualquiera puede crear y utilizar. Para obtener más información sobre cómo crear extensiones de CLI de GitHub, consulta la sección "Crear extensiones de CLI de GitHub".
Las extensiones se instalan localmente y se les da el alcance del usuario. Por lo tanto, si accedes al CLI de GitHub desde una máquina diferente o si otro usuario accede al CLI de GitHub desde la misma máquina, la extensión no estará disponible.
Encontrar extensiones
Puedes encontrar extensiones si buscas los repositorios con el tema gh-extension.
Instalar extensiones
Para instalar una extensión, utiliza el subcomando extensions install. Reemplaza el parámetro repo con el repositorio de la extensión. Puedes utilizar la URL completa, tal como https://github.com/octocat/gh-whoami, o solo el propietario y repositorio, tal como octocat/gh-whoami.
Si se utiliza el propietario y repositorio, gh instalará la extensión utilizando el nombre de host en el cual está autenticado gh. El formato de URL completa es útil cuando se instalan extensiones desde un host diferente. Por ejemplo, los usuarios de GitHub Enterprise Server deben utilizar la URL completa del repositorio para instalar extensiones de GitHub.com o de cualquier otro host.
Para instalar una extensión en desarrollo desde el directorio actual, utiliza . como el valor para el parámetro repo.
gh extension install repoSi ya tienes una extensión con el mismo nombre instalada, el comando fallará. Por ejemplo, si instalaste octocat/gh-whoami, debes desinstalarlo antes de instalar hubot/gh-whoami.
Ver las extensiones instaladas
Para ver las extensiones instaladas, utiliza el subcomando extensions list. La salida también te dirá qué extensiones tienen actualizaciones disponibles.
gh extension listActualizar las extensiones
Para actualizar una extensión, utiliza el subcomando extensions upgrade. Reemplaza el parámetro extension con el nombre de la extensión.
gh extension upgrade extensionPara actualizar todas las extensiones instaladas, utiliza el marcador --all.
gh extension upgrade --allDesinstalar las extensiones
Para desinstalar una extensión, utiliza el subcomando extensions remove. Reemplaza al parámetro extension con el nombre de la extensión.
gh extension remove extension