¿Por qué usar GitHub CLI?
GitHub CLI lleva GitHub a tu terminal. Te permite clonar, crear, bifurcar y ver repositorios, así como manejar issues y pull requests con comandos para listar, crear, ver y fusionar estos. También puedes gestionar gists, activar y revisar los workflows de GitHub Actions, y hacer solicitudes directas a la API. Además, tienes opciones de autenticación y configuración disponibles para gestionar el acceso y los settings, mientras que las funcionalidades de búsqueda te ayudan a encontrar repositorios, issues y más.
Parte 1: Instalar GitHub CLI 🔨
gh está disponible a través de Homebrew, MacPorts, Conda, Spack, Webi, y como un binario descargable que incluye el instalador para Mac OS .pkg desde la página de lanzamientos.
brew install gh
# MacPorts
sudo port install gh
# Conda
conda install gh –channel conda-forge
# Spack
spack install gh
# Webi
curl -sS https://webi.sh/gh | sh
gh está disponible a través de WinGet, scoop, Chocolatey, Conda, Webi, y como instalador MSI.
winget install –id GitHub.cli
# scoop
scoop install gh
# Chocolatey
choco install gh
# Conda
conda install gh –channel conda-forge
# Spack
spack install gh
# Webi
curl -sS https://webi.sh/gh | sh
Aquí realmente depende de lo que estés usando; puedes leer la documentación de instalación para Linux para encontrar lo que necesitas, o verificar aquí los comandos dependiendo de la distribución que estés usando.
sudo pacman -S github-cli
# Debian, Ubuntu Linux, Raspberry Pi OS (apt)
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y))
&& sudo mkdir -p -m 755 /etc/apt/keyrings
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg
&& echo “deb [arch=$(dpkg –print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main” | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
&& sudo apt update
&& sudo apt install gh -y
# Actualizar
sudo apt update
sudo apt install gh
# Fedora, CentOS, Red Hat Enterprise Linux (dnf)
sudo dnf install ‘dnf-command(config-manager)’
sudo dnf config-manager –add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh –repo gh-cli
# Alternativamente, instalar desde el repositorio comunitario:
sudo dnf install gh
# Actualizar
sudo dnf update gh
# openSUSE/SUSE Linux (zypper)
sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
sudo zypper ref
sudo zypper install gh
# Actualizar
sudo zypper ref
sudo zypper update gh
Parte 2: Iniciar sesión 🔐
Primero escribe en tu terminal:
Te pedirá:
> GitHub.com
GitHub Enterprise Server
Si eliges GitHub.com, te pedirá:
> HTTPS
SSH
A continuación, te preguntará tu protocolo y preferencia personal. Recomiendo SSH.
HTTPS
> SSH
Ahora solo crea la contraseña para tu clave SSH, el título y selecciona cómo te gustaría autenticarte, y si es la primera vez, solo usa Iniciar sesión con un navegador web.
Ingresa una frase de contraseña para tu nueva clave SSH (Opcional): **************************
? Título para tu clave SSH: (GitHub CLI) TheMachine-Desktop
? ¿Cómo te gustaría autenticar GitHub CLI? [Usa las flechas para moverte, escribe para filtrar]
> Iniciar sesión con un navegador web
Pegar un token de autenticación
! Primero copia tu código de un solo uso: 1234-ABCD
Presiona Enter para abrir github.com en tu navegador…
🎉 ¡Felicidades! 🎉, ahora puedes usar GitHub desde tu terminal 🖥️. Si escribes gh auth status, deberías obtener algo como esto:
github.com
✓ Conectado a la cuenta github.com nombredeusuario (/home/username/.config/gh/hosts.yml)
– Cuenta activa: true
– Protocolo de operaciones de Git: ssh
– Token: …
– Ámbitos del token: .…
Parte 3: Comandos útiles 📝
Aquí te daré ⭐Mis 5 comandos principales en GitHub CLI🏅 para que te hagas una idea de lo que eres capaz de hacer, pero siéntete libre de revisar la documentación para obtener un conocimiento más profundo de esta herramienta.
1 – Clonar un repositorio de GitHub 🥇: gh repo clone owner/repo
Bonus 🎁:
Como estás usando ssh, también puedes ir a esta sección de un repositorio de GitHub:
Y puedes ver el README.md del repositorio:
2 – Crear un nuevo repositorio en GitHub 🥈: gh repo create repo, puedes usar opciones como –public, private, –description <string> y más.
3 – Crear un nuevo gist 🥉: gh gist create <file>
Bonus 🎁:
También puedes listar los gists:
4 – Crear un nuevo issue 🏅: gh issue create –title <title> –body <body>
Bonus 🎁:
También puedes crear issues:
Cuerpo del issue”
ver issues:
Y cerrar issues:
5 – Listar pull requests 🌟: gh pr list
Bonus 🎁:
También puedes ver la pull request:
fusionar una pull request:
Y revisarla:
Pensamientos finales 🎉
GitHub CLI lleva GitHub a tu terminal, ¡haciendo que sea increíblemente poderoso! 🚀 Espero que hayas encontrado útil este post y que te haya inspirado a sacar el máximo provecho de esta herramienta. ¡No olvides suscribirte para recibir más actualizaciones de mis futuros posts! 🙌🖥️
Fuentes 📚
Instalar GitHub CLI
Instalar GitHub CLI en Linux
Manual de GitHub CLI
Código de Apollo 11
Aquí me gustaría agregar una frase personal, pero todavía estoy pensando/buscando una 😂