GitHub CLI

La CLI gh administra pull requests, issues, ejecuciones de Actions y releases desde la terminal, de forma similar a como los equipos de Python ya automatizan uv y pytest en CI.

Receta

gh auth login
gh pr create --fill --base main
gh pr checks --watch
gh pr merge --squash --delete-branch

Cuándo usar esto:

• Abrir PRs sin salir de la terminal
• Observar el flujo de trabajo de ruff/pytest tras un push
• Etiquetado masivo de issues o carga de assets de release
• Automatizar la higiene del repositorio en runbooks del equipo de plataforma

Ejemplo de Trabajo

# Después del trabajo de una característica
git push -u origin feat/bill-42-tax
 
gh pr create \
  --title "feat(billing): add tax line item [BILL-42]" \
  --body "Adds VAT calculation; updates uv.lock for pydantic bump." \
  --reviewer @acme/billing-team
 
# Observar CI (mismos pasos que en .github/workflows/pr.yml)
gh pr checks 42 --watch
 
# Cambios solicitados abordados - fusionar cuando esté en verde
gh pr merge 42 --squash --delete-branch

Lo que esto demuestra:

• --fill usa mensajes de commit para el cuerpo del borrador cuando es apropiado
• --watch se bloquea hasta que las comprobaciones requeridas se completan
• Política de fusión squash alineada con la documentación de branching
• La eliminación automática de ramas mantiene el repositorio remoto ordenado

Análisis Profundo

Cómo Funciona

• gh auth - Almacena el token o usa SSH para operaciones git.
• gh pr - Envuelve las Pull Requests de GitHub REST/GraphQL.
• gh run - Lista y visualiza las ejecuciones de flujos de trabajo de Actions.
• gh api - API sin procesar autenticada para scripts personalizados.

Comandos de Alto Valor

Notas de Python

# Comentar fragmento de fallo de pytest en PR
gh pr comment 42 --body "$(uv run pytest -q 2>&1 | tail -20)"

Errores Comunes

• Alcance del token de autenticación - Se necesitan repo y workflow para Actions privadas. Solución: gh auth refresh -s repo,workflow.
• Repositorio predeterminado incorrecto - gh apunta al remoto del directorio actual. Solución: gh repo set-default acme/billing-api.
• Fusionar antes de que CI esté en verde - Ignora la política si es administrador. Solución: esperar a gh pr checks.
• Plantilla de PR omitida - Cuerpos vacíos ralentizan la revisión. Solución: .github/pull_request_template.md + gh pr create --template.
• Fuga de secretos en comentarios - Los logs pegados pueden incluir tokens. Solución: redactar antes de gh pr comment.
• Discrepancia entre squash y merge - La política de la organización puede prohibir squash. Solución: gh pr merge --merge según ADR.

Alternativas

Preguntas Frecuentes

Relacionado

• Comandos Esenciales de Git - git push antes de PR
• Pipelines de CI/CD - paridad de flujos de trabajo
• Branching y Merging - políticas de fusión
• Mejores Prácticas de Git - normas de git del equipo

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.