Como funciona

Copilot CLI é a interface de linha de comando do GitHub Copilot. Ela permite conversar com um agente de programação diretamente no terminal, perguntar sobre um projeto e solicitar mudanças. A documentação oficial explica que a ferramenta pode ler e modificar arquivos, executar comandos e realizar tarefas com várias etapas, de acordo com as permissões e o modo escolhido.

Para iniciar uma sessão interativa, a pessoa abre o terminal na pasta do projeto e executa o comando indicado no guia oficial de início do Copilot CLI:

Terminal
copilot

Antes de continuar, a ferramenta pode pedir confirmação de que a pasta é confiável. Esse cuidado importa porque, durante uma sessão, o agente pode tentar acessar arquivos e executar comandos dentro do diretório. A documentação também descreve modos de uso em que uma tarefa pode ser executada localmente ou delegada a um agente na nuvem; as permissões e o local de execução são diferentes.

Exemplo prático

Uma pessoa desenvolvedora quer entender por que um teste de integração falha. No terminal, ela pode pedir ao Copilot CLI que investigue o teste, explique quais arquivos parecem relacionados e proponha uma correção.

O agente pode consultar o código e, quando autorizado, executar o teste ou outros comandos. A pessoa acompanha a atividade, revisa o diff e verifica se a solução atende ao comportamento esperado. Se o agente sugerir uma alteração ampla ou executar uma ação inesperada, interrompa a sessão e examine os comandos realizados.

Para uma tarefa em várias etapas, o pedido deve definir objetivo, arquivos ou limites relevantes e como validar o resultado. Por exemplo, peça para corrigir uma mensagem de erro e adicionar um teste específico, sem solicitar uma reescrita geral do projeto. Um escopo claro facilita revisar o que mudou.

Para que serve

Copilot CLI é útil para trabalhar com código sem sair do terminal: explorar um repositório, explicar uma função, criar ou depurar código, rodar verificações e apoiar fluxos do GitHub. Também pode ser usado de forma programática em scripts, conforme a documentação de automação, mas isso exige controles apropriados para cada ambiente.

A interface de terminal não torna a ferramenta automaticamente segura. Não inicie uma sessão em uma pasta desconhecida ou que contenha arquivos não confiáveis sem entender as permissões. Evite conceder acesso amplo a credenciais, dados pessoais ou comandos destrutivos. Em automações, limite a pasta, revise as saídas e não use aprovação automática sem compreender o risco.

Copilot CLI e o antigo recurso gh copilot não são a mesma interface. Consulte a documentação atual do GitHub para instalação, autenticação, opções e disponibilidade, pois esses detalhes podem mudar. Em qualquer modo, revise as alterações, rode testes independentes e mantenha o controle de versão para poder recuperar o estado anterior.