Github

• Vuoi che un agente monitori o classifichi le issue e le pull request di GitHub per tuo conto.
• Devi ispezionare lo stato della pipeline CI/CD — elencando le esecuzioni dei workflow, visualizzando i log degli step falliti o diagnosticando una build non riuscita.
• Hai bisogno di output JSON strutturato da GitHub per elaborazioni o reportistica downstream.
• Vuoi interrogare gli endpoint REST API di GitHub che vanno oltre quanto esposto dai sottocomandi standard di gh (ad esempio, recuperare campi specifici di una PR con filtri --jq).

• Devi interagire con GitHub a livello di protocollo Git (clonazione, push di commit, rebase) — questa competenza riguarda le API della piattaforma GitHub, non le operazioni Git di basso livello.
• Hai bisogno di GitLab, Bitbucket o un altro host non Github; la CLI gh è esclusiva di GitHub.

Elenca, visualizza e controlla lo stato delle pull request con comandi come gh pr checks e gh pr list. Funziona sempre su qualsiasi repository specificando --repo owner/repo, anche al di fuori di una directory git.

Ispeziona le esecuzioni dei workflow di GitHub Actions con gh run list, gh run view e --log-failed per visualizzare solo i log degli step falliti. Ideale per gli agenti che devono diagnosticare pipeline interrotte senza dover cercare manualmente nei log.

Il comando gh api sblocca qualsiasi endpoint delle API REST di GitHub. Combinalo con i filtri --jq per estrarre esattamente i campi di cui hai bisogno — ad esempio, recuperando il titolo, lo stato e l'autore di una PR in un'unica chiamata.

La maggior parte dei sottocomandi gh supporta i flag --json in modo che le risposte possano essere instradate in espressioni --jq o consumate direttamente da strumenti a valle. Questo rende semplice per gli agenti analizzare e agire sui dati di Github in modo programmatico.

Elenca e filtra i problemi con gh issue list, incluso l'output JSON per query strutturate. Supporta il filtraggio per etichette, stato, assegnatario e altro tramite i flag standard di gh.

Un agente controlla tutte le PR aperte, recupera il loro stato CI tramite gh pr checks e mette in evidenza le PR che presentano errori o sono bloccate, fornendo allo sviluppatore un elenco prioritario senza dover controllare manualmente la dashboard.

Quando una build si interrompe, l'agente esegue gh run view <run-id> --log-failed per recuperare solo i log dei passaggi falliti e riassume la causa principale, salvando gli ingegneri dallo scorrere lunghi output CI.

L'agente interroga le issue aperte con gh issue list --json e filtri --jq per generare un report strutturato — raggruppando per etichetta, anzianità o assegnatario — da utilizzare come digest settimanale del team.

Utilizzando gh api con query --jq personalizzate, un agente recupera metadati specifici (ad es. SHA del commit di merge di una PR, elenco dei revisori o tempi di esecuzione dei workflow) che non sono accessibili tramite i sottocomandi standard.