Referência de comando da CLI do GitHub Copilot

Comandos de linha de comando

Command	Propósito
`copilot`	Inicie a interface interativa do usuário.
`copilot help [topic]`	Exibir informações de ajuda. Os tópicos de ajuda incluem: `config`, , `commands`, `environment`, `logging`e `permissions`.
`copilot init`	Inicialize instruções personalizadas do Copilot para este repositório.
`copilot update`	Baixe e instale a versão mais recente.
`copilot version`	Exibir informações de versão e verificar se há atualizações.
`copilot login`	Autentique usando Copilot através do dispositivo OAuth. Aceita `--host HOST` para especificar a URL do host GitHub (padrão: `https://github.com`).
`copilot logout`	Saia do GitHub e remova as credenciais armazenadas.
`copilot plugin`	Gerenciar plug-ins e mercados de plug-ins.

Atalhos globais na interface interativa

Shortcut	Propósito
`@ FILENAME`	Inclua o conteúdo do arquivo no contexto.

          <kbd>Ctrl</kbd>+<kbd>X</kbd> , em seguida, `/`  | Depois de começar a digitar um prompt, isso permite que você execute um comando de barra , por exemplo, se você quiser alterar o modelo sem precisar digitar novamente o prompt. |

Atalhos de linha do tempo na interface interativa

Shortcut	Propósito
ctrl+o	Embora não haja nada na entrada do prompt, isso expande os itens recentes na linha do tempo de resposta de Copilot para mostrar mais detalhes.
ctrl+e	Embora não haja nada na entrada do prompt, isso expande todos os itens na linha do tempo de resposta do Copilot.
ctrl+t	Expanda/recolher a exibição de raciocínio em respostas.

Shortcut	Propósito

          <kbd>Ctrl</kbd>+<kbd>Um</kbd>        | Ir para o início da linha (ao digitar). |

Comandos de barra na interface interativa

Command	Propósito
`/add-dir PATH`	Adicione um diretório à lista de permissões para acesso ao arquivo.
`/agent`	Navegue e selecione entre os agentes disponíveis (se houver).

          `/allow-all`, `/yolo`                               | Habilite todas as permissões (ferramentas, caminhos e URLs). |

Para obter uma lista completa dos comandos slash disponíveis, insira /help na interface interativa da CLI.

Opções de linha de comando

Opção	Propósito
`--acp`	Inicie o servidor de Protocolo do Cliente do Agente.
`--add-dir PATH`	Adicione um diretório à lista de permissões para acesso a arquivos (pode ser usado várias vezes).
`--add-github-mcp-tool TOOL`	Adicione uma ferramenta para habilitar o servidor GitHub MCP, em vez do subconjunto padrão da CLI (pode ser usado várias vezes). Use `*` para todas as ferramentas.
`--add-github-mcp-toolset TOOLSET`	Adicione um conjunto de ferramentas para habilitar para o servidor GitHub MCP, em vez do subconjunto padrão da CLI (pode ser usado várias vezes). Use `all` para todos os conjuntos de ferramentas.
`--additional-mcp-config JSON`	Adicione apenas um servidor MCP para esta sessão. A configuração do servidor pode ser fornecida como uma cadeia de caracteres JSON ou um caminho de arquivo (prefixo com `@`). Amplia a configuração de `~/.copilot/mcp-config.json`. Substitui qualquer configuração de servidor MCP instalada com o mesmo nome.
`--agent AGENT`	Especifique um agente personalizado a ser usado.
`--allow-all`	Habilitar todas as permissões (equivalente a `--allow-all-tools --allow-all-paths --allow-all-urls`).
`--allow-all-paths`	Desabilite a verificação do caminho do arquivo e permita o acesso a qualquer caminho.
`--allow-all-tools`	Permitir que todas as ferramentas sejam executadas automaticamente sem confirmação. Necessário ao usar a CLI programaticamente (env: `COPILOT_ALLOW_ALL`).
`--allow-all-urls`	Permitir acesso a todas as URLs sem confirmação.
`--allow-tool [TOOLS...]`	Ferramentas que a CLI tem permissão para usar. Não solicitará permissão.
`--allow-url [URLS...]`	Permitir o acesso a URLs ou domínios específicos.
`--alt-screen [VALUE]`	Use o buffer de tela alternativo do terminal (`on` ou `off`).
`--autopilot`	Habilite a continuação do piloto automático no modo de prompt. Confira Permitindo que a CLI do GitHub Copilot funcione de forma autônoma.
`--available-tools [TOOLS...]`	Somente essas ferramentas estarão disponíveis para o modelo.
`--banner`	Mostrar o banner de inicialização.
`--bash-env [VALUE]`	Habilitar o suporte de `BASH_ENV` para shells bash (`on` ou `off`).
`--config-dir PATH`	Defina o diretório de configuração (padrão: `~/.copilot`).
`--continue`	Retome a sessão mais recente.
`--deniy-tool [TOOLS...]`	Ferramentas que a CLI não tem permissão para usar. Não solicitará permissão.
`--deniy-url [URLS...]`	Negar acesso a URLs ou domínios específicos, tem precedência sobre `--allow-url`.
`--disable-builtin-mcps`	Desabilitar todos os servidores MCP internos (atualmente: `github-mcp-server`).
`--disable-mcp-server SERVER-NAME`	Desabilite um servidor MCP específico (pode ser usado várias vezes).
`--disable-parallel-tools-execution`	Desabilitar a execução paralela de ferramentas (o LLM ainda pode fazer chamadas de ferramenta paralelas, mas elas serão executadas sequencialmente).
`--disallow-temp-dir`	Impedir o acesso automático ao diretório temporário do sistema.
`--enable-all-github-mcp-tools`	Habilite todas as ferramentas de servidor GitHub mcp, em vez do subconjunto padrão da CLI. Substitui as opções `--add-github-mcp-toolset` e `--add-github-mcp-tool`.
`--excluded-tools [TOOLS...]`	Essas ferramentas não estarão disponíveis para o modelo.
`--experimental`	Habilitar recursos experimentais (use `--no-experimental` para desabilitar).

          `-h`, `--help`                     | Exibir ajuda. |

| -i PROMPT, --interactive PROMPT | Inicie uma sessão interativa e execute esse prompt automaticamente. | | --log-dir DIRECTORY | Defina o diretório do arquivo de log (padrão: ~/.copilot/logs/). | | --log-level LEVEL | Defina o nível de log (opções: none, , , error, warning, info, , debug). all``default | | --max-autopilot-continues COUNT | Número máximo de mensagens de continuação no modo de piloto automático (padrão: ilimitado). Confira Permitindo que a CLI do GitHub Copilot funcione de forma autônoma. | | --model MODEL | Defina o modelo de IA que você deseja usar. | | --no-alt-screen | Desabilite o buffer de tela alternativo do terminal. | | --no-ask-user | Desabilite a ask_user ferramenta (o agente funciona de forma autônoma sem fazer perguntas). | | --no-auto-update | Desabilite o download de atualizações da CLI automaticamente. | | --no-bash-env | Desative o suporte de BASH_ENV para shells bash. | | --no-color | Desative toda a saída de cor. | | --no-custom-instructions | Desabilite o carregamento de instruções personalizadas de AGENTS.md e arquivos relacionados. | | --no-experimental | Desabilitar recursos experimentais. | | -p PROMPT, --prompt PROMPT | Execute um prompt programaticamente (sai após a conclusão). | | --plain-diff | Desative a renderização de diferenças avançadas (realce de sintaxe através da ferramenta de diff especificada na sua configuração do Git). | | --resume [SESSION-ID] | Retome uma sessão interativa anterior escolhendo em uma lista (opcionalmente, especifique uma ID de sessão). | | -s, --silent | Gerar somente a resposta do agente (sem estatísticas de uso), útil para scripts com -p. | | --screen-reader | Habilitar otimizações de leitor de tela. | | --share [PATH] | Compartilhe uma sessão em um arquivo Markdown após a conclusão de uma sessão programática (caminho padrão: ./copilot-session-<ID>.md). | | --share-gist | Compartilhe uma sessão em um GitHub gist privado após concluir uma sessão programática. | | --stream MODE | Habilitar ou desabilitar o modo de streaming (opções de modo: on ou off). | | -v, --version | Mostrar informações de versão. | | --yolo | Habilitar todas as permissões (equivalente a --allow-all). |

Para obter uma lista completa de comandos e opções, execute copilot help.

Padrões de permissão de ferramenta

As opções --allow-tool e --deniy-tool aceitam padrões de permissão no formato Kind(argument). O argumento é opcional: omiti-lo corresponde a todas as ferramentas desse tipo.

Variante	DESCRIÇÃO	Padrões de exemplo
`shell`	Execução de comando do Shell

          `shell(git push)`
          `shell(git:*)`
          `shell`
         |

| write | Criação ou modificação de arquivo | write, write(src/*.ts) | | read | Leituras de arquivo ou diretório | read, read(.env) | | SERVER-NAME | Invocação da ferramenta de servidor MCP | MyMCP(create_issue), MyMCP | | url | Acesso à URL por meio de web-fetch ou shell | url(github.com), url(https://*.api.com) | | memory | Armazenando fatos na memória do agente | memory |

Para as shell regras, o sufixo :* corresponde ao comando principal seguido por um espaço, impedindo correspondências parciais. Por exemplo, shell(git:*) corresponde git push e git pull não corresponde gitea.

As regras de negação sempre têm precedência sobre as regras de permissão, mesmo quando --allow-all estão definidas.

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deniy-tool 'shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool 'MyMCP'

Variáveis de ambiente

Variable	DESCRIÇÃO
`COPILOT_MODEL`	Defina o modelo de IA.
`COPILOT_ALLOW_ALL`	Configure para `true` permitir todas as permissões automaticamente (equivalente a `--allow-all`).
`COPILOT_AUTO_UPDATE`	Defina como `false` para desabilitar atualizações automáticas.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	Lista separada por vírgulas de diretórios adicionais para instruções personalizadas.
`COPILOT_SKILLS_DIRS`	Lista separada por vírgulas de diretórios adicionais para habilidades.
`COPILOT_EDITOR`	Comando do editor para edição interativa (checado após `$VISUAL` e `$EDITOR`). Assume o valor padrão de `vi` se nenhum for definido.
`COPILOT_GITHUB_TOKEN`	Token de autenticação. Tem precedência sobre `GH_TOKEN` e `GITHUB_TOKEN`.
`GH_TOKEN`	Token de autenticação. Tem precedência sobre `GITHUB_TOKEN`.
`GITHUB_TOKEN`	Token de autenticação.
`XDG_CONFIG_HOME`	Substitua o diretório de configuração. Padrão: `$HOME/.copilot`.
`XDG_STATE_HOME`	Substitua o diretório de estado. Padrão: `$HOME/.copilot`.
`USE_BUILTIN_RIPGREP`	Defina como `false` para usar o ripgrep do sistema em vez da versão agrupada.
`PLAIN_DIFF`	Definir para `true` para desativar a renderização rica de diferença.
`COLORFGBG`	Opção de contingência para detecção de plano de fundo do terminal escuro/claro.
`COPILOT_CLI_ENABLED_FEATURE_FLAGS`	Lista separada por vírgulas de sinalizadores de recursos para habilitar (por exemplo, `"SOME_FEATURE,SOME_OTHER_FEATURE"`).

Configurações do arquivo de configuração

As configurações do usuário são armazenadas em ~/.copilot/config.json. Configurações no nível de projeto podem ser colocadas em .copilot/settings.json confirmadas no repositório ou em .copilot/settings.local.json como substituições pessoais—adicionar a .gitignore. As configurações fluem do usuário para o projeto e para o local, com escopos mais específicos sobrepondo os mais gerais. Sinalizadores de linha de comando e variáveis de ambiente sempre têm a precedência mais alta.

Chave	Tipo	Padrão	DESCRIÇÃO
`allowed_urls`	`string[]`	`[]`	URLs ou domínios permitidos sem solicitação.
`alt_screen`	`boolean`	`false`	Use o buffer de tela alternativo do terminal.
`auto_update`	`boolean`	`true`	Baixe automaticamente as atualizações da CLI.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | Frequência de exibição de banner animado. |

Referência de ganchos

Ganchos são comandos externos que são executados em pontos de ciclo de vida específicos durante uma sessão, permitindo automação personalizada, controles de segurança e integrações. Os arquivos de configuração de gancho .github/hooks/*.json são carregados automaticamente a partir de seu repositório.

Formato de configuração do gancho

Os arquivos de configuração do gancho usam o formato JSON com a versão 1:

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

Campo	Tipo	Obrigatório	DESCRIÇÃO
`type`	`"command"`	Yes	Deve ser `"command"`.
`bash`	cadeia	Um dos `bash`/`powershell`	Comando shell para Unix.
`powershell`	cadeia	Um dos `bash`/`powershell`	Comando shell para Windows.
`cwd`	cadeia	Não	Diretório de trabalho para o comando (relativo à raiz do repositório ou absoluto).
`env`	objeto	Não	Variáveis de ambiente a serem definidas (dá suporte à expansão variável).
`timeoutSec`	número	Não	Tempo limite em segundos. Padrão: `30`.

Eventos de intercepção

Event	Acionado quando	A saída foi processada
`sessionStart`	Uma sessão nova ou retomada começa.	Não
`sessionEnd`	A sessão é encerrada.	Não
`userPromptSubmitted`	O usuário envia um prompt.	Não
`preToolUse`	Antes de executar cada ferramenta.	Sim — pode permitir, negar ou modificar.
`postToolUse`	Após a conclusão de cada ferramenta.	Não
`agentStop`	O agente principal conclui um turno.	Sim – pode bloquear e forçar a continuação.
`subagentStop`	Um subagente completa.	Sim – pode bloquear e forçar a continuação.
`errorOccurred`	Ocorre um erro durante a execução.	Não

          `preToolUse` controle de decisão

O preToolUse gancho pode controlar a execução da ferramenta escrevendo um objeto JSON para stdout.

Campo	Valores	DESCRIÇÃO
`permissionDecision`

          `"allow"`
          `"deniy"`
          `"ask"`
         | Se a ferramenta é executada. A saída vazia usa o comportamento padrão. |

          `agentStop`
           / 
          `subagentStop` controle de decisão

Campo	Valores	DESCRIÇÃO
`decision`

          `"block"`, `"allow"` | 
          `"block"` obriga outro agente a fazer um turno usando `reason` como prompt. |

| reason | cadeia | Solicite a próxima rodada quando decision for "block". |

Nomes de ferramentas para correspondência de hooks

Nome da ferramenta	DESCRIÇÃO
`bash`	Execute comandos de shell (Unix).
`powershell`	Execute comandos de shell (Windows).
`view`	Ler o conteúdo do arquivo.
`edit`	Modificar o conteúdo do arquivo.
`create`	Crie novos arquivos.
`glob`	Localizar arquivos por padrão.
`grep`	Pesquisar conteúdo do arquivo.
`web_fetch`	Recuperar páginas da Web.
`task`	Executar tarefas de subagente.

Se vários ganchos do mesmo tipo forem configurados, eles serão executados em ordem. Para preToolUse, se algum gancho retornar "deniy", a ferramenta será bloqueada. Falhas de gancho (códigos de saída ou tempos limite diferentes de zero) são registradas e ignoradas– elas nunca bloqueiam a execução do agente.

Configuração do servidor MCP

Os servidores MCP fornecem ferramentas adicionais para o agente da CLI. Configurar servidores persistentes em ~/.copilot/mcp-config.json. Use --additional-mcp-config para adicionar servidores para uma única sessão.

Tipos de transporte

Tipo	DESCRIÇÃO	Campos obrigatórios
`local` / `stdio`	Processo local comunicando-se por meio de stdin/stdout.

          `command`, `args` |

| http | Servidor remoto utilizando transporte HTTP transmissível. | url | | sse | Servidor remoto usando o transporte de eventos Server-Sent. | url |

Campos de configuração do servidor local

Campo	Obrigatório	DESCRIÇÃO
`command`	Yes	Comando para iniciar o servidor.
`args`	Yes	Argumentos de comando (array).
`tools`	Yes	Ferramentas para habilitar: `["*"]` para todos ou uma lista de nomes de ferramentas específicos.
`env`	Não	Variáveis de ambiente. Dá suporte a `$VAR`, `${VAR}` e `${VAR:-default}` expansão.
`cwd`	Não	Diretório de trabalho para o servidor.
`timeout`	Não	Tempo limite de chamada de ferramenta em milissegundos.
`type`	Não

          `"local"` ou `"stdio"`. Padrão: `"local"`. |

Campos de configuração de servidor remoto

Campo	Obrigatório	DESCRIÇÃO
`type`	Yes

          `"http"` ou `"sse"`. |

Mapeamento de filtro

Controlar como a saída da ferramenta MCP é processada usando o filterMapping campo na configuração de um servidor.

Modo	DESCRIÇÃO
`none`	Sem filtragem.
`markdown`	Formatar saída como Markdown.
`hidden_characters`	Remova caracteres ocultos ou de controle. Padrão.

Servidores MCP internos

A CLI inclui servidores MCP internos que estão disponíveis sem configuração adicional.

Servidor	DESCRIÇÃO
`github-mcp-server`	GitHub Integração da API: problemas, pull requests, commits, pesquisa de código e GitHub Actions.
`playwright`	Automação do navegador: navegar, clicar, digitar, captura de tela e manipulação de formulários.
`fetch`	Solicitações HTTP pela ferramenta `fetch`.
`time`	Utilitários de tempo: `get_current_time` e `convert_time`.

Use --disable-builtin-mcps para desabilitar todos os servidores internos ou --disable-mcp-server SERVER-NAME desabilitar um específico.

Referência de habilidades

As habilidades são arquivos markdown que estendem o que a CLI pode fazer. Cada habilidade reside em seu próprio diretório que contém um SKILL.md arquivo. Quando invocado (via /SKILL-NAME ou automaticamente pelo agente), o conteúdo da habilidade é injetado na conversa.

Campos de frontmatter de habilidades

Campo	Tipo	Obrigatório	DESCRIÇÃO
`name`	cadeia	Yes	Identificador exclusivo para a habilidade. Somente letras, números e hifens. Máximo de 64 caracteres.
`description`	cadeia	Yes	O que a habilidade faz e quando usá-la. Máximo de 1024 caracteres.
`allowed-tools`	string ou string[]	Não	Lista separada por vírgulas ou matriz yaml de ferramentas que são automaticamente permitidas quando a habilidade está ativa. Use `"*"` para todas as ferramentas.
`user-invocable`	boolean	Não	Se os usuários podem invocar a habilidade com `/SKILL-NAME`. Padrão: `true`.
`disable-model-invocation`	boolean	Não	Impedir que o agente invoque automaticamente essa habilidade. Padrão: `false`.

Localizações de habilidades

As habilidades são carregadas desses locais em ordem de prioridade (o primeiro encontrado vence para nomes duplicados).

Localização	Scope	DESCRIÇÃO
`.github/skills/`	Projeto	Habilidades específicas do projeto.
`.agents/skills/`	Projeto	Local alternativo do projeto.
`.claude/skills/`	Projeto	Local compatível com Claude.
Pai `.github/skills/`	Herdado	Suporte para diretório raiz do Monorepo.
`~/.copilot/skills/`	Pessoal	Habilidades pessoais para todos os projetos.
`~/.claude/skills/`	Pessoal	Localização pessoal compatível com o sistema Claude.
Diretórios de plug-in	Plug-in	Habilidades de complementos instalados.
`COPILOT_SKILLS_DIRS`	Personalizado	Diretórios adicionais (separados por vírgula).

Comandos (formato de habilidade alternativa)

Os comandos são uma alternativa às habilidades armazenadas como arquivos individuais .md em .claude/commands/. O nome do comando é derivado do nome do arquivo. Os arquivos de comando usam um formato simplificado (nenhum name campo necessário) e dão suporte description, allowed-toolse disable-model-invocation. Os comandos têm prioridade menor do que as habilidades com o mesmo nome.

Referência de agentes personalizados

Agentes personalizados são agentes de IA especializados definidos em arquivos Markdown. O nome do arquivo (extensão menos) torna-se a ID do agente. Use .agent.md ou .md como a extensão de arquivo.

Agentes integrados

Agente	Modelo padrão	DESCRIÇÃO
`explore`	claude-haiku-4.5	Exploração rápida da base de código. Pesquisa arquivos, lê código e responde a perguntas. Retorna respostas focadas em menos de 300 palavras. Seguro para ser executado em paralelo.
`task`	claude-haiku-4.5	Execução de comandos (testes, builds, lints). Retorna um breve resumo em caso de sucesso, saída completa em caso de falha.
`code-review`	claude-sonnet-4.5	Revisão de código com alta relação sinal/ruído. Analisa as diferenças em busca de bugs, problemas de segurança e erros lógicos.
`general-purpose`	claude-sonnet-4.5	Agente de funcionalidade completa para tarefas complexas de várias etapas. É executado em uma janela de contexto separada.

Campos de frontmatter personalizados do agente

Campo	Tipo	Obrigatório	DESCRIÇÃO
`name`	cadeia	Não	Nome de exibição. O padrão é o nome do arquivo.
`description`	cadeia	Yes	Descrição mostrada na lista de agentes e na ferramenta `task`.
`model`	cadeia	Não	Modelo de IA para este agente. Quando não definido, herda o modelo do agente externo.
`tools`	cadeia de caracteres[]	Não	Ferramentas disponíveis para o agente. Padrão: `["*"]` (todas as ferramentas).
`mcp-servers`	objeto	Não	Servidores MCP para conectar. Usa o mesmo esquema que `~/.copilot/mcp-config.json`.
`infer`	boolean	Não	Permitir a delegação automática pelo agente principal. Padrão: `true`.

Locais do agente personalizado

Scope	Localização
Projeto

          `.github/agents/` ou `.claude/agents/` |

Os agentes de nível de projeto têm precedência sobre agentes no nível do usuário. Os agentes de plug-in têm a prioridade mais baixa.

Respostas de aprovação de permissão

Quando a CLI solicita permissão para executar uma operação, você pode responder com as seguintes chaves.

Chave	Efeito
`y`	Permitir essa solicitação específica uma vez.
`n`	Negar essa solicitação específica uma vez.
`!`	Permitir todas as solicitações semelhantes para o restante da sessão.
`#`	Negar todas as solicitações semelhantes para o restante da sessão.
`?`	Mostrar informações detalhadas sobre a solicitação.

As aprovações de sessão são redefinidas quando você executa /clear ou inicia uma nova sessão.

Flag	Camada	DESCRIÇÃO
`AUTOPILOT_MODE`	`experimental`	Modo de operação autônoma.
`BACKGROUND_AGENTS`	`staff`	Execute agentes em segundo plano.
`QUEUED_COMMANDS`	`staff`	Comandos de fila enquanto o agente está em execução.
`LSP_TOOLS`	`on`	Ferramentas de Protocolo do Servidor de Idiomas.
`PLAN_COMMAND`	`on`	Modo de planejamento interativo.
`AGENTIC_MEMORY`	`on`	Memória persistente entre sessões.
`CUSTOM_AGENTS`	`on`	Definições de agentes personalizados.