Skip to main content

Usar o GitHub Copilot na CLI

Você pode usar gh, a interface de linha de comando do GitHub, para trabalhar com o GitHub Copilot in the CLI.

Quem pode usar esse recurso?

O GitHub Copilot in the CLI atualmente está em versão beta pública e sujeito a alterações.

Os proprietários de organizações ou empresas com uma assinatura do GitHub Copilot Business ou GitHub Copilot Enterprise podem decidir se concedem acesso ao beta do GitHub Copilot in the CLI para usuários em sua organização ou empresa.

Caso tenha uma assinatura do GitHub Copilot Individual, agora terá acesso à versão beta do GitHub Copilot in the CLI.

Sobre o uso do GitHub Copilot in the CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para saber mais, confira "Sobre o a CLI do GitHub".

GitHub Copilot in the CLI é uma extensão do GitHub CLI que fornece uma interface semelhante a chat no terminal que permite fazer perguntas sobre a linha de comando. Você pode pedir ao Copilot in the CLI para sugerir um comando para seu caso de uso, com gh copilot suggest, ou para explicar um comando sobre o qual você está curioso, com gh copilot explain.

Pré-requisitos

  • Para usar o Copilot in the CLI, é preciso ter uma assinatura ativa do GitHub Copilot. Para obter mais informações, confira "Sobre a cobrança para o GitHub Copilot".
  • Para usar o Copilot in the CLI, você deve ter o GitHub CLI.instalado. Para obter instruções de instalação para GitHub CLI, veja o repositório GitHub CLI.

Instalar o Copilot in the CLI

Se você ainda não fez isso, execute gh auth login para se autenticar com sua conta do GitHub.

Para instalar a extensão do Copilot in the CLI, execute gh extension install github/gh-copilot.

Para atualizar o Copilot in the CLI, execute gh extension upgrade gh-copilot.

Usar o Copilot in the CLI

Para usar gh para trabalhar com o GitHub Classroom, digite gh copilot SUBCOMMAND. Além disso, você pode usar gh copilot --help para ajuda geral ou gh copilot SUBCOMMAND --help para ajuda com um subcomando específico.

Pedir ao Copilot in the CLI para explicar um comando

Você pode pedir ao Copilot in the CLI para explicar um comando para você executando:

gh copilot explain

Como alternativa, você pode adicionar o comando que deseja explicar diretamente ao prompt:

gh copilot explain "sudo apt-get"

O Copilot in the CLI pode ajudar explicando o que um comando faz em linguagem simples. Isso torna mais fácil para você entender a finalidade do comando e como ele funciona para um exemplo específico. Você não precisa passar pela documentação do comando porque a explicação inclui informações sobre o que o comando faz como entrada e produz como saída, e fornece exemplos práticos.

Pedir ao Copilot in the CLI para sugerir um comando

Você pode pedir ao Copilot in the CLI para sugerir um comando para você executando:

gh copilot suggest

Isso iniciará uma experiência interativa para obter o comando que você precisa. O Copilot in the CLI tem como objetivo sugerir comandos que ajudem você a executar as tarefas que você está tentando concluir. Para ajudar o Copilot in the CLI a fornecer melhores sugestões, você pode especificar o tipo de comando que está procurando (genérico git ou gh).

Se você já sabe qual comando precisa, também poderá incluí-lo no prompt. Por exemplo, se você quiser instalar o Git, poderá pedir ao Copilot in the CLI para sugerir um comando para você:

gh copilot suggest "Install git"

Se o resultado não for exatamente o que você está procurando, você poderá continuar revisando sua pergunta até que o comando retornado atenda às suas expectativas. Você pode fazer isso selecionando a opção Revisar comando.

Depois de gerar o comando perfeito para sua tarefa, você poderá copiá-lo facilmente para a área de transferência para executá-lo sempre que precisar, selecionando a opção Copiar para área de transferência.

Compartilhar feedback sobre o Copilot in the CLI

Se você encontrar problemas ou limitações com o Copilot in the CLI, poderá fornecer feedback selecionando a opção Taxa de resposta no Copilot in the CLI.