Ir para o conteúdo
Promovaweb

GitHub, delegação e automação no 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 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

  1. O login do GitHub já vem junto
  2. Autopilot local ou delegação para a nuvem
  3. Uma instrução, uma resposta e o processo termina
  4. O mesmo agente dentro do GitHub Actions
  5. O CLI também atende outros programas
  6. Onde cada formato se encaixa

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.

  1. Instrução

    Você escreve /delegate ou começa a mensagem com o caractere &.

  2. Checkpoint

    O Copilot oferece commitar as mudanças pendentes numa branch nova.

  3. Agente de nuvem

    O trabalho roda no GitHub, em segundo plano, num pull request em rascunho.

  4. Revisão

    O agente solicita a sua revisão quando termina as mudanças.

O comando /delegate entrega a tarefa ao agente de nuvem do Copilot, que trabalha numa branch própria e devolve o resultado como pull request em rascunho.

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.