O que gh-cli faz?
Referência completa do GitHub CLI (gh) para repositórios, issues, pull requests, Actions, projetos, releases, gists, codespaces, organizações, extensões e todas as operações do GitHub a partir da linha de comando.
Comandos Principais
Repositórios
gh repo create: Cria um novo repositório no GitHub.gh repo clone <repositorio>: Clona um repositório para o diretório local.gh repo view <repositorio>: Visualiza detalhes de um repositório.gh repo fork: Cria um fork de um repositório.
Issues
gh issue create: Cria uma nova issue.gh issue list: Lista issues abertas.gh issue view <numero>: Visualiza detalhes de uma issue.gh issue close <numero>: Fecha uma issue.
Pull Requests
gh pr create: Cria um novo pull request.gh pr list: Lista pull requests abertos.gh pr view <numero>: Visualiza detalhes de um pull request.gh pr merge <numero>: Mescla um pull request.gh pr review <numero>: Adiciona uma revisão a um pull request.
GitHub Actions
gh workflow list: Lista workflows do Actions.gh workflow run <workflow>: Dispara um workflow manualmente.gh run list: Lista execuções de workflows.gh run view <id>: Visualiza detalhes de uma execução.gh run watch <id>: Acompanha logs de uma execução em tempo real.
Projetos
gh project list: Lista projetos.gh project view <numero>: Visualiza detalhes de um projeto.gh project item-add <project-number> --body <content>: Adiciona um item a um projeto.
Releases
gh release create <tag>: Cria uma nova release.gh release list: Lista releases.gh release view <tag>: Visualiza detalhes de uma release.
Gists
gh gist create <arquivo>: Cria um novo gist.gh gist list: Lista gists.gh gist view <id>: Visualiza detalhes de um gist.
Codespaces
gh codespace create: Cria um novo codespace.gh codespace list: Lista codespaces.gh codespace code: Abre um codespace no VS Code.gh codespace delete: Exclui um codespace.
Organizações
gh org list: Lista organizações do usuário.gh org members: Lista membros de uma organização.
Extensões
gh extension install <nome>: Instala uma extensão do gh.gh extension list: Lista extensões instaladas.gh extension upgrade <nome>: Atualiza uma extensão.
Configuração
gh auth login: Faz login no GitHub.gh auth status: Verifica o status de autenticação.gh config set <chave> <valor>: Define uma configuração.gh config get <chave>: Obtém o valor de uma configuração.
Utilitários
gh help: Exibe ajuda geral.gh <comando> --help: Exibe ajuda para um comando específico.gh version: Mostra a versão do gh instalada.
Exemplos de Uso
# Clonar um repositório
gl repo clone claude-code/super-tool
# Criar uma issue
gl issue create --title "Corrigir bug de login" --body "Descrição detalhada do bug"
# Criar um pull request, revisar e mesclar
gl pr create --title "Adicionar nova feature" --body "Descrição"
gl pr review 42 --approve
gl pr merge 42
# Executar um workflow manualmente
gl workflow run deploy.yml --ref main
# Criar uma release com assets
gl release create v1.0.0 --title "v1.0.0" --notes "Notas da release" ./dist/meu-app.zip
Dicas
- Utilize
--helpem qualquer comando para ver opções detalhadas. - Configure alias para comandos frequentes:
gl alias set prc "pr create". - Combine comandos com scripts bash para automação de tarefas repetitivas.
- Mantenha o gh atualizado:
gl upgrade.
Referências
- Documentação oficial: https://cli.github.com/manual/
- Repositório do GitHub CLI: https://github.com/cli/cli
- Guia de extensões: https://github.com/topics/gh-extension