Question 1

Como instalo o gh CLI?

Accepted Answer

No macOS, use brew install gh. No Windows, use winget install GitHub.cli ou choco install gh. No Linux, use o gerenciador de pacotes da sua distribuição ou baixe diretamente da página de releases oficial.

Question 2

Como criar um PR para um branch não padrão?

Accepted Answer

Use a flag --base: gh pr create --base [target-branch]. Por exemplo, para criar um PR para o branch develop, use gh pr create --base develop.

Question 3

Como gerenciar múltiplos repositórios com gh?

Accepted Answer

A maioria dos comandos gh aceita a flag -R ou --repo para especificar um repositório. Exemplo: gh issue list -R owner/repo. Você pode gerenciar issues e PRs de outros repositórios mesmo sem estar em um diretório git.

Question 4

O que posso fazer com gh api?

Accepted Answer

gh api permite chamar diretamente a API REST e GraphQL do GitHub. Recursos não suportados diretamente pelos comandos gh podem ser acessados através da API. Por exemplo, gh api /user obtém info do usuário atual, e gh api repos/{owner}/{repo}/topics obtém os topics do repositório.

Comando	Descrição
`gh auth login`	Fazer login no GitHub
`gh auth logout`	Fazer logout
`gh auth status`	Verificar status de autenticação
`gh auth refresh`	Atualizar token de autenticação
`gh auth switch`	Trocar conta

Comando	Descrição
`gh repo create [name]`	Criar novo repositório
`gh repo clone [repo]`	Clonar repositório
`gh repo fork [repo]`	Fazer fork do repositório
`gh repo view`	Ver informações do repositório
`gh repo view --web`	Abrir no navegador
`gh repo list [user]`	Listar repositórios
`gh repo delete [repo]`	Excluir repositório
`gh repo rename [new-name]`	Renomear repositório

Comando	Descrição
`gh issue list`	Listar issues
`gh issue create`	Criar issue (interativo)
`gh issue create -t "[title]" -b "[body]"`	Criar issue (inline)
`gh issue view [number]`	Ver detalhes do issue
`gh issue close [number]`	Fechar issue
`gh issue reopen [number]`	Reabrir issue
`gh issue edit [number]`	Editar issue
`gh issue comment [number] -b "[body]"`	Adicionar comentário ao issue

Comando	Descrição
`gh pr list`	Listar PRs
`gh pr create`	Criar PR (interativo)
`gh pr create -t "[title]" -b "[body]"`	Criar PR (inline)
`gh pr view [number]`	Ver detalhes do PR
`gh pr checkout [number]`	Checkout do branch do PR
`gh pr merge [number]`	Mesclar PR
`gh pr merge --squash`	Squash e mesclar
`gh pr merge --rebase`	Rebase e mesclar
`gh pr close [number]`	Fechar PR
`gh pr review [number]`	Revisar PR
`gh pr diff [number]`	Ver diff do PR

Comando	Descrição
`gh run list`	Listar execuções de workflow
`gh run view [run-id]`	Ver detalhes da execução
`gh run watch [run-id]`	Assistir progresso da execução
`gh run rerun [run-id]`	Reexecutar workflow
`gh run cancel [run-id]`	Cancelar execução
`gh run download [run-id]`	Baixar artefatos
`gh workflow list`	Listar workflows
`gh workflow run [workflow]`	Executar workflow manualmente
`gh workflow enable [workflow]`	Habilitar workflow
`gh workflow disable [workflow]`	Desabilitar workflow

GitHub CLI Cheatsheet

#Autenticação

#Repositório

#Issues

#Pull Request

#GitHub Actions

#Releases

#Gist

#Pesquisa

#API e outros

#Perguntas frequentes (FAQ)

Comando	Descrição
`gh release list`	Listar releases
`gh release create [tag]`	Criar release
`gh release create [tag] --generate-notes`	Gerar notas automaticamente
`gh release view [tag]`	Ver detalhes do release
`gh release download [tag]`	Baixar assets do release
`gh release upload [tag] [files]`	Enviar assets
`gh release delete [tag]`	Excluir release

Comando	Descrição
`gh gist list`	Listar gists
`gh gist create [file]`	Criar gist
`gh gist create --public [file]`	Criar gist público
`gh gist view [id]`	Ver gist
`gh gist edit [id]`	Editar gist
`gh gist clone [id]`	Clonar gist
`gh gist delete [id]`	Excluir gist

Comando	Descrição
`gh search repos [query]`	Pesquisar repositórios
`gh search issues [query]`	Pesquisar issues
`gh search prs [query]`	Pesquisar PRs
`gh search code [query]`	Pesquisar código
`gh search commits [query]`	Pesquisar commits

Comando	Descrição
`gh api [endpoint]`	Chamar API do GitHub
`gh api graphql -f query="..."`	Consulta GraphQL
`gh browse`	Abrir repo atual no navegador
`gh browse [file]`	Abrir arquivo no navegador
`gh alias set [alias] "[command]"`	Definir alias de comando
`gh extension list`	Listar extensões
`gh extension install [repo]`	Instalar extensão