¿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 🔨
macOS 🍎
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.
# Homebrew
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
Windows 🪟
gh está disponible a través de WinGet, scoop, Chocolatey, Conda, Webi, y como instalador MSI.
# WinGet
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
Linux 🐧
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.
# Arch
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:
gh auth login
Te pedirá:
? ¿En qué cuenta deseas iniciar sesión? [Usa las flechas para moverte, escribe para filtrar]
> GitHub.com
GitHub Enterprise Server
Si eliges GitHub.com, te pedirá:
? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host? [Usa las flechas para moverte, escribe para filtrar]
> HTTPS
SSH
A continuación, te preguntará tu protocolo y preferencia personal. Recomiendo SSH.
? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host? [Usa las flechas para moverte, escribe para filtrar]
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.
? ¿Generar una nueva clave SSH para agregar a tu cuenta de GitHub? (Y/n) Y
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:
$ gh auth status
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
gh repo clone chrislgarry/Apollo-11
Bonus 🎁:
Como estás usando ssh, también puedes ir a esta sección de un repositorio de GitHub:
Y git clone de esta manera:
Y puedes ver el README.md del repositorio:
gh repo view chrislgarry/Apollo-11
2 - Crear un nuevo repositorio en GitHub 🥈: gh repo create repo, puedes usar opciones como --public, private, --description <string> y más.
gh repo create my-new-repo --public
3 - Crear un nuevo gist 🥉: gh gist create <file>
gh gist create file.txt
Bonus 🎁:
También puedes listar los gists:
gh gist list
4 - Crear un nuevo issue 🏅: gh issue create --title <title> --body <body>
gh issue create --title "Título del issue" --body "Cuerpo del issue"
Bonus 🎁:
También puedes crear issues:
gh issue create --title "Título del issue" --body "
Cuerpo del issue"
ver issues:
gh issue view <número-del-issue>
Y cerrar issues:
gh issue close <número-del-issue>
5 - Listar pull requests 🌟: gh pr list
gh pr list
Bonus 🎁:
También puedes ver la pull request:
gh pr view <número-del-pr>
fusionar una pull request:
gh pr merge <número-del-pr>
Y revisarla:
gh pr review --approve --body "¡Se ve bien!"
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 😂
SOCIAL SHARE CARD GENERATOR