GitHub: herramienta oficial GitHub CLI 🛠️

Si eres un desarrollador o trabajas en proyectos colaborativos en GitHub, seguramente ya conoces lo poderosa que puede ser esta plataforma. GitHub no solo te permite almacenar y gestionar tu código, sino que también te ofrece una serie de herramientas para optimizar tu flujo de trabajo. Una de las más útiles es gh-cli, la herramienta de línea de comandos oficial de GitHub.

En este artículo, vamos a explorar qué es gh-cli, cómo instalarla y algunas de sus funcionalidades más útiles para mejorar tu productividad en GitHub.

¿Qué es Github CLI?

GitHub CLI es una interfaz de línea de comandos diseñada para facilitar la interacción con GitHub sin necesidad de abrir un navegador. Al utilizar la terminal, puedes realizar diversas acciones que normalmente requerirían acceder a la interfaz web, lo que ahorra tiempo y te permite realizar tareas de manera más rápida y eficiente.

Con gh-cli, puedes gestionar repositorios, crear pull requests, revisar issues, visualizar el historial de commits, interactuar con GitHub Actions, y mucho más, todo directamente desde tu terminal.

1. Instalar GitHub CLI

Instalar gh-cli es bastante sencillo y está disponible para diferentes sistemas operativos, incluyendo macOS, Windows y Linux.

• windows
• macOS
• linux

• En Windows, gh está disponible a través de WinGet, Chocolatey, y como instalador MSI:

  # WinGet
  winget install --id GitHub.cli
  
  # Chocolatey
  choco install gh
  

• Si usas Homebrew, puedes instalar gh con el siguiente comando:

  brew install gh
  

• Si usas Linux, puedes instalar gh directamente desde los repositorios de tu distribución:

  sudo apt install gh  # Para distribuciones basadas en Debian/Ubuntu
  sudo yum install gh  # Para distribuciones basadas en Red Hat
  

Una vez instalada, puedes verificar que todo esté en orden con el siguiente comando:

gh --version

2. Autenticación

Después de instalar GitHub CLI, necesitamos conectarlo con nuestra GitHub.

Para hacer esto, previamente debes tener tu cuenta de GitHub con la sesión abierta para facilitar las acciones que nos indicará el comando para autenticarnos.

En la terminal o símbolo de sistema escribe el siguiente comando:

gh auth login

Esto iniciará un asistente que nos irá preguntando qué deseamos hacer. A continuación, puedes revisar una simulación:

mcherrera@dev:~$ gh auth login

? What account do you want to log into?  [Use arrows to move, type to filter]
> GitHub.com
  GitHub Enterprise Server

? What is your preferred protocol for Git operations on this host?  [Use arrows to move, type to filter]
 HTTPS
> SSH

? Upload your SSH public key to your GitHub account?  [Use arrows to move, type to filter]
  /home/mcherrera/.ssh/id_ed25519.pub
> /home/mcherrera/.ssh/id_rsa.pub
  Skip

? Title for your SSH key: (GitHub CLI) No escribas nada. Si la llave seleccionada se encuentra registrada en GitHub, gh la detectará y no intentará subirla de nuevo.

? How would you like to authenticate GitHub CLI?  [Use arrows to move, type to filter]
> Login with a web browser
  Paste an authentication token

! First copy your one-time code: 11F7-CC2A
Press Enter to open github.com in your browser... 

Demostración:

Principales funciones de GitHub CLI

1. Clonar Repositorios

Aunque Git ya permite clonar repositorios desde la línea de comandos, con gh-cli puedes hacer esto aún más rápido.

gh repo clone <usuario>/<repositorio>

2. Gestionar Pull Requests

Puedes crear, listar, revisar y hacer merge de pull requests sin necesidad de entrar al navegador. Algunos comandos útiles son:

• Crear un Pull Request:

gh pr create --base main --head <tu-rama> --title "Título del PR" --body "Descripción detallada"

• Ver los Pull Requests abiertos:

gh pr list

• Revisar un Pull Request:

gh pr view <ID-del-PR>

3. Gestionar Issues

Si trabajas en proyectos con varios colaboradores, gestionar issues desde la terminal puede ser muy eficiente.

• Crear un Issue:

gh issue create --title "Nuevo Bug" --body "Descripción del problema"

• Ver Issues Abiertos:

gh issue list

• Cerrar un Issue:

gh issue close <ID-del-Issue>

4. Visualizar GitHub Actions

Si tu proyecto usa GitHub Actions para CI/CD, puedes visualizar el estado de tus workflows directamente desde la terminal.

gh run list

Ventajas de Usar gh-cli

1. Ahorro de Tiempo: Evita la necesidad de navegar por la interfaz web de GitHub para realizar tareas simples. Todo se hace directamente desde tu terminal.
2. Automatización: Puedes integrar gh-cli en scripts y flujos de trabajo personalizados, lo que facilita tareas repetitivas o procesos automatizados.
3. Productividad: No tienes que cambiar de ventana o de aplicación para revisar tu repositorio, crear issues o gestionar pull requests.
4. Compatibilidad: Funciona bien con otras herramientas y comandos de Git, lo que facilita el trabajo en proyectos grandes y complejos.

gh-cli es una herramienta esencial para desarrolladores que buscan mejorar su flujo de trabajo y aumentar su productividad en GitHub. Con esta herramienta, puedes gestionar repositorios, pull requests, issues y mucho más directamente desde la terminal, sin tener que abrir el navegador constantemente. Si aún no la has probado, ¡es hora de instalarla y comenzar a aprovechar sus ventajas!

Si te interesa saber más sobre herramientas que pueden mejorar tu productividad como desarrollador, no olvides seguir mi blog y explorar más artículos sobre el tema.

Recursos Adicionales

• Documentación oficial de GitHub CLI
• Repositorio de GitHub CLI en GitHub

También te comparto un cheatsheet (hoja de referencia rápida) para que tengas siempre contigo. 👇