GitHub, delegação e automação no Copilot CLI
VPS 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.
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 usa o seu login do GitHub para ler e criar issues, abrir pull requests e delegar tarefas ao agente de nuvem do Copilot, que trabalha numa branch própria. Com a opção -p, o mesmo agente recebe uma única instrução e encerra, o que leva o CLI para scripts, pipelines e workflows do GitHub Actions.
Sumário da página
O login do GitHub já vem junto
Você recebe uma issue atribuída e cola o link no Copilot CLI com a instrução de começar o trabalho numa branch com um nome adequado. O agente lê a issue, cria a branch e começa a editar o código. Esse exemplo está na documentação do GitHub, ao lado de outras instruções diretas: listar os seus pull requests abertos, listar as issues atribuídas a você num repositório, abrir uma issue de melhoria sobre um arquivo aberto e não fechado no código e revisar as mudanças de um pull request em busca de erros graves.
Esse acesso vem do mesmo login do GitHub usado para entrar no CLI e do servidor MCP do GitHub, que o agente traz configurado. Quando o Copilot abre um pull request por sua instrução, você aparece como autor. Por isso as permissões e a revisão continuam importando. O revisor do outro lado não sabe quais linhas o agente escreveu.
As instruções também cobrem o GitHub Actions. Você pode solicitar a lista dos workflows do repositório que comentam em pull requests. Também pode solicitar um workflow novo que rode o ESLint em cada pull request, mostre os avisos na comparação das mudanças e reprove a verificação quando houver erro. A documentação usa esse caso como exemplo completo, terminando com o push da branch nova e a abertura do pull request.
Autopilot local ou delegação para a nuvem
O Copilot CLI oferece duas formas de entregar uma tarefa ao agente. O Autopilot roda na sua máquina, dentro da sessão: você libera as permissões e acompanha o progresso em tempo real. O comando /delegate empurra a tarefa para o agente de nuvem do Copilot no GitHub. Lá, o trabalho segue em segundo plano e continua mesmo se você desligar o computador.
Instrução
Você escreve
/delegateou começa a mensagem com o caractere&.Checkpoint
O Copilot oferece commitar as mudanças pendentes numa branch nova.
Agente de nuvem
O trabalho roda no GitHub, em segundo plano, num pull request em rascunho.
Revisão
O agente solicita a sua revisão quando termina as mudanças.
A delegação começa com /delegate ou com o caractere & no início da mensagem. Antes de a tarefa sair da máquina, o Copilot oferece commitar as mudanças não preparadas como um ponto de partida, numa branch nova. O agente de nuvem abre um pull request em rascunho, faz as alterações e solicita a sua revisão. Por padrão, o pull request aponta para a branch atual. A opção --base escolhe outra. O CLI mostra o link do pull request e da sessão do agente assim que o trabalho começa.
Uma instrução, uma resposta e o processo termina
No modo programático, você entrega a instrução com -p ou --prompt, ou envia o texto por um pipe. O CLI encerra ao terminar a tarefa. A documentação traz exemplos curtos: escrever a mensagem de commit das mudanças preparadas, resumir o que um arquivo faz em até cem palavras, escrever testes unitários para um módulo e corrigir os erros do ESLint do projeto.
Esse formato exige cuidados próprios. A opção -s suprime os metadados da sessão e deixa só o texto, útil quando outro programa lê a saída. A opção --no-ask-user desliga as perguntas de esclarecimento, porque ninguém vai responder. A opção --model fixa o modelo para o comportamento não mudar entre ambientes. As permissões entram pela linha de comando, com a orientação oficial de liberar o mínimo. Uma tarefa que só usa o Git recebe --allow-tool='shell(git:*)'. A liberação total fica só para dentro de uma sandbox.
O mesmo agente dentro do GitHub Actions
Um uso comum do modo programático é um passo de workflow no GitHub Actions. O exemplo da documentação gera um relatório de cobertura de testes com um único comando do CLI, usando -s, a liberação de shell(npm:*) e de write e a opção --no-ask-user. Para a maior parte da automação, a documentação recomenda os GitHub Agentic Workflows. Quando o workflow chama o CLI direto, a autenticação pode usar o GITHUB_TOKEN do próprio workflow, em repositórios da organização, ou a variável COPILOT_GITHUB_TOKEN com um token pessoal guardado como segredo do repositório.
O token pessoal precisa ser do tipo aceito pelo CLI. A documentação de autenticação lista o token fine-grained com a permissão Copilot Requests entre os aceitos e registra que o token clássico, com prefixo ghp_, não funciona. O changelog da versão 1.0.112 mostra outro caminho em evolução: o comando copilot workflow run aceita login da Microsoft 365, cobrança por uso e provedores de modelo próprios mesmo sem login no GitHub.
O CLI também atende outros programas
O Agent Client Protocol, ou ACP, é um padrão aberto para conversar com agentes de IA. Pelo servidor ACP do Copilot CLI, ferramentas, IDEs e sistemas de automação de terceiros que falam esse protocolo usam o CLI como agente. O repositório oficial também publica uma imagem de container em ghcr.io/github/copilot-cli, para linux/amd64 e linux/arm64, que roda o CLI como servidor para clientes do Copilot SDK. Essa imagem não é para uso interativo no terminal.
Onde cada formato se encaixa
A conversa interativa serve para o trabalho que você acompanha e corrige no caminho. O Autopilot serve para uma tarefa bem descrita, com resultado e verificação claros, que você deixa rodar na máquina. A delegação serve para a tarefa que pode seguir sozinha no GitHub e voltar como pull request. O modo programático serve para tarefas repetidas, com permissões fechadas, em scripts e no CI. Em todos os casos, o resultado chega para a sua revisão antes de ir para a branch principal.