Ir para o conteúdo
Promovaweb

O que é o GitHub Copilot CLI

StayCloudVPS Agêntica

30% off na sua VPS Agêntica nos 2 primeiros meses

A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

Aproveitar a Black Friday

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O GitHub Copilot CLI é a interface de linha de comando do GitHub Copilot, que leva o agente do Copilot para o terminal do seu projeto. Ele responde perguntas, escreve e corrige código e conversa com o GitHub, usando a mesma estrutura agêntica do agente de nuvem do Copilot.

Sumário da página

  1. Uma conversa no terminal que mexe no projeto
  2. Duas interfaces: a conversa e o comando único
  3. Três modos mudam o ritmo da sessão
  4. A conversa longa é compactada antes de chegar ao limite
  5. Voltar atrás tem comando próprio
  6. Onde o Copilot CLI entra no seu trabalho
  7. A revisão continua com você

Uma conversa no terminal que mexe no projeto

Você abre o terminal na pasta do projeto, digita copilot e manda trocar a cor de fundo dos títulos H1 para azul-escuro. O agente procura o arquivo CSS dos títulos. Em seguida, apresenta a edição planejada e espera a sua resposta antes de gravar. Esse exemplo está na documentação oficial do GitHub. Nele aparece o trabalho inteiro da ferramenta: você indica o resultado, o Copilot encontra os arquivos e só executa a ação depois da sua aprovação.

O Copilot CLI lê arquivos, edita código, roda comandos de shell e repete o ciclo até a tarefa fechar. O repositório oficial descreve o produto como o agente de código do Copilot trazido para a linha de comando. Com o mesmo login do GitHub que você já usa, ele acessa os seus repositórios, issues e pull requests.

O nome se confunde com o de uma ferramenta antiga, mas o produto é outro. A extensão gh copilot do GitHub CLI sugeria e explicava comandos de terminal. O Copilot CLI atual é um programa próprio, com o comando copilot. As versões saem com frequência no repositório github/copilot-cli, acompanhadas de um changelog público com as mudanças de cada release.

  1. Instrução

    Você descreve o resultado esperado em linguagem natural.

  2. Leitura

    O agente procura arquivos, lê o código e consulta o Git.

  3. Aprovação

    Edições e comandos aguardam a sua resposta, salvo o que você já liberou.

  4. Resultado

    A saída do comando ou da edição orienta a próxima ação.

O agente propõe cada ação, você aprova ou recusa e o resultado volta como informação para o próximo passo, até a tarefa terminar.

Duas interfaces: a conversa e o comando único

A interface interativa abre com copilot e mantém uma conversa. Dentro dela você passa uma ou mais tarefas, comenta o que o agente fez e corrige a direção no meio do caminho. A interface programática recebe uma única instrução pela opção -p ou --prompt, completa a tarefa e encerra o processo. Esse segundo formato serve para scripts e pipelines, assunto do hub sobre GitHub e automação.

Na conversa, você não precisa esperar o agente terminar para falar de novo. A documentação descreve mensagens enfileiradas: você manda uma instrução nova enquanto ele pensa. Ela entra como correção de rumo ou como próxima tarefa. Ao recusar uma permissão, você pode explicar o motivo na mesma resposta. O Copilot ajusta a abordagem sem abandonar o trabalho.

Três modos mudam o ritmo da sessão

A tecla Shift+Tab alterna entre os modos. O modo padrão pergunta e executa, uma ação de cada vez. O modo Plan analisa a tarefa, faz perguntas sobre o escopo e monta um plano estruturado antes de escrever qualquer código. Com esse modo, você pega um mal-entendido antes da primeira edição, quando corrigir ainda é barato.

O modo Autopilot incentiva o agente a seguir trabalhando até a tarefa terminar, sem esperar uma nova mensagem a cada etapa. A documentação separa três controles que costumam ser confundidos. O Autopilot controla a continuação. A opção --allow-all, com o apelido --yolo, controla as aprovações. A opção --no-ask-user desliga as perguntas de esclarecimento. Um não liga os outros, então você combina os três conforme a tarefa.

Para trabalho complexo, o GitHub sugere planejar primeiro e só depois liberar a execução autônoma. Você revisa o plano no modo Plan, solicita ajustes e escolhe aceitar o plano e continuar em Autopilot. A opção --max-autopilot-continues limita quantas continuações o agente faz sozinho. O teto de crédito de cada resposta fica em --max-ai-credits, e o /limits ajusta esse limite dentro da sessão.

A conversa longa é compactada antes de chegar ao limite

Todo modelo tem um limite de tokens por conversa. O Copilot CLI compacta o histórico em segundo plano quando a conversa chega perto de 95% desse limite, sem interromper o trabalho. O comando /compact faz a compactação na hora que você quiser. O /context mostra como a janela de tokens está sendo ocupada. Com isso, uma sessão longa continua útil depois de horas de trabalho no mesmo problema.

Voltar atrás tem comando próprio

Com o agente parado, duas batidas na tecla Esc abrem o seletor de pontos de retorno. O comando /undo, com o apelido /rewind, faz o mesmo. Você escolhe uma mensagem anterior e decide entre voltar só a conversa ou voltar a conversa junto com os arquivos. Antes de restaurar, o Copilot mostra uma prévia por arquivo.

A restauração cobre só os arquivos que o Copilot alterou e pula qualquer arquivo editado por você depois dele, para não apagar o seu trabalho. O recurso funciona também em pastas que não são repositórios Git. O retorno não pode ser desfeito: o histórico posterior ao ponto escolhido some da sessão. Para cancelar uma ação em andamento, Esc solicita confirmação. Já o Ctrl+C cancela na hora, sem deixar arquivo pela metade.

Onde o Copilot CLI entra no seu trabalho

Os exemplos oficiais se dividem em dois grupos. No projeto local, você manda mudar um trecho de código, entender as últimas alterações de um arquivo, reescrever a documentação, fazer commits ou criar um protótipo do zero. No GitHub, você lista os seus pull requests abertos, passa uma issue para o agente trabalhar numa branch nova, abre pull requests e issues, revisa as mudanças de um pull request e cria workflows do GitHub Actions.

O GitHub também oferece uso do navegador e, no macOS e no Windows, uso do computador, para tarefas em sites e em programas de interface gráfica sem API. Os dois recursos dependem de habilitação e aparecem marcados como prévia na documentação.

A revisão continua com você

O agente executa com as permissões do seu login e da sua máquina. Um pull request criado por ele sai com você como autor. Por isso, a documentação recomenda revisar com cuidado cada comando sugerido antes de aprovar e iniciar o CLI só em pastas que você confia. Um teste que passa mostra que o comando terminou sem erro, mas não prova que a mudança atende ao que o cliente precisa. Para trabalhar com agentes de código ao lado de um desenvolvedor experiente, o Desenvolvimento Colaborativo da Dev Side Studio acompanha o código do seu produto no editor e no terminal.