GitHub CLI (gh)

¿Qué es GitHub CLI (gh)?

GitHub CLI, conocido como gh, es la herramienta de línea de comandos oficial de GitHub. Trae el poder de GitHub a tu terminal, permitiéndote gestionar repositorios, trabajar con incidencias (issues), manejar pull requests e interactuar con GitHub Actions sin salir de tu entorno de línea de comandos. Está diseñado para optimizar tu flujo de trabajo, reducir el cambio de contexto y hacer que la creación de scripts y la automatización sean fluidas.

Características Clave

• Gestión Completa de Repositorios: Crea, clona, bifurca (fork) y visualiza repositorios directamente desde el CLI.
• Incidencias y Pull Requests: Lista, visualiza, crea y gestiona incidencias y pull requests. Incluso puedes descargar las ramas de los PR, revisar código y fusionarlos.
• Integración con GitHub Actions: Visualiza el estado de los flujos de trabajo, sigue los registros en vivo y descarga artefactos de las ejecuciones de los flujos de trabajo.
• Gists y Releases: Crea y gestiona gists, y maneja lanzamientos de software, incluida la carga de activos.
• Extensibilidad: Crea comandos personalizados y alias para adaptar gh a tus necesidades y flujos de trabajo específicos.
• Autenticación: Se autentica de forma segura con tu cuenta de GitHub utilizando flujos basados en navegador o en tokens.

Casos de Uso

• Automatización y Scripting: Automatiza tareas repetitivas como crear pull requests, configurar nuevos repositorios o gestionar incidencias en masa.
• Integración CI/CD: Usa gh en tus pipelines de CI/CD para interactuar con GitHub, como crear un lanzamiento después de una compilación exitosa.
• Flujo de Trabajo Centrado en la Terminal: Para los desarrolladores que viven en la terminal, gh proporciona una forma de realizar casi todas las tareas relacionadas con GitHub sin una GUI.
• Verificaciones Rápidas de Estado: Comprueba rápidamente el estado de un pull request o mira las últimas incidencias de un proyecto con un solo comando.

Primeros Pasos

Aquí tienes una guía sencilla al estilo “Hola Mundo” para empezar a usar gh.

1. Instalación: En macOS, puedes usar Homebrew:

   brew install gh
   

   Para otros sistemas como Windows o Linux, consulta la guía de instalación oficial.

2. Autenticación: Inicia sesión en tu cuenta de GitHub. Este comando abrirá una ventana del navegador para que autorices el CLI.

   gh auth login
   

3. Crear y Clonar un Repositorio: Vamos a crear un nuevo repositorio público y a clonarlo.

   # Crear un nuevo repositorio en GitHub
   gh repo create mi-app-cli --public --source=. --remote=origin
   
   # Clonar un repositorio existente
   gh repo clone cli/cli
   

4. Listar Incidencias: Navega al directorio de un repositorio clonado y lista sus incidencias abiertas.

   cd cli
   gh issue list
   

Precios

GitHub CLI (gh) es completamente gratuito y de código abierto, distribuido bajo la Licencia MIT. Puedes usarlo sin ningún costo tanto para proyectos personales como comerciales.

Comunidad

Como herramienta oficial de GitHub, gh tiene una comunidad masiva y activa. El proyecto cuenta con decenas de miles de estrellas en GitHub y es ampliamente elogiado por su robusto conjunto de características y por mejorar significativamente la productividad de los desarrolladores. La retroalimentación es abrumadoramente positiva y la herramienta se considera madura y estable para el uso diario.