Github

• Quieres que un agente monitoree o haga triaje de issues y pull requests de GitHub en tu nombre.
• Necesitas inspeccionar el estado del pipeline de CI/CD — listar ejecuciones de workflows, ver logs de pasos fallidos o diagnosticar una build rota.
• Necesitas una salida JSON estructurada de GitHub para procesamiento posterior o generación de informes.
• Quieres consultar endpoints de la API REST de GitHub que van más allá de lo que exponen los subcomandos estándar de gh (por ejemplo, obtener campos específicos de un PR con filtros --jq).

• Necesitas interactuar con GitHub a nivel de protocolo Git (clonar, hacer push de commits, rebase) — esta habilidad es para la API de la plataforma Github, no para operaciones Git directas.
• Necesitas usar GitLab, Bitbucket u otro host que no sea Github; el CLI gh es exclusivo de GitHub.

Lista, visualiza y comprueba el estado de las pull requests con comandos como gh pr checks y gh pr list. Siempre funciona con cualquier repositorio especificando --repo owner/repo, incluso fuera de un directorio git.

Inspecciona las ejecuciones de flujos de trabajo de Github Actions con gh run list, gh run view y --log-failed para mostrar únicamente los registros de los pasos fallidos. Ideal para agentes que necesitan diagnosticar pipelines rotos sin tener que buscar manualmente en los registros.

El comando gh api desbloquea cualquier endpoint de la API REST de GitHub. Combínalo con filtros --jq para extraer exactamente los campos que necesitas — por ejemplo, obteniendo el título, el estado y el autor de un PR en una sola llamada.

La mayoría de los subcomandos de gh admiten indicadores --json para que las respuestas puedan canalizarse hacia expresiones --jq o ser consumidas directamente por herramientas posteriores. Esto facilita que los agentes analicen y actúen sobre los datos de Github de forma programática.

Lista y filtra problemas con gh issue list, incluyendo salida en JSON para consultas estructuradas. Admite filtrado por etiquetas, estado, asignado y más mediante los indicadores estándar de gh.

Un agente verifica todos los PRs abiertos, obtiene su estado de CI mediante gh pr checks y muestra los PRs que están fallando o detenidos, proporcionando al desarrollador una lista priorizada sin necesidad de revisar el panel manualmente.

Cuando una compilación falla, el agente ejecuta gh run view <run-id> --log-failed para obtener únicamente los registros del paso fallido y resume la causa raíz, evitando que los ingenieros tengan que desplazarse por extensas salidas de CI.

El agente consulta las incidencias abiertas con gh issue list --json y filtros --jq para generar un informe estructurado — agrupando por etiqueta, antigüedad o responsable — para un resumen semanal del equipo.

Usando gh api con consultas personalizadas --jq, un agente recupera metadatos específicos (por ejemplo, el SHA del commit de fusión de un PR, la lista de revisores o los tiempos de ejecución de flujos de trabajo) que no están disponibles a través de los subcomandos estándar.