referência de comando da CLI 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: , , , , e .
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 para especificar a URL do host GitHub (padrão: ).
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.
CtrlX , 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.
Esc	Cancele a operação atual.
! COMMAND	Execute um comando em seu shell local, ignorando Copilot.
CtrlC	Cancelar a operação/limpar a entrada. Pressione duas vezes para sair.
CtrlD	Desligamento.
CtrlL	Limpar a tela.
ShiftGuia	Ciclo entre o modo padrão, plano e piloto automático.

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.

Atalhos de navegação na interface interativa

Shortcut	Propósito
CtrlUm	Ir para o início da linha (ao digitar).
CtrlB	Mova para o caractere anterior.
CtrlE	Mover para o final da linha (quando se está digitando).
CtrlF	Mova para o próximo caractere.
CTRLG	Edite o prompt em um editor externo.
CTRLH	Exclua o caractere anterior.
CtrlK	Apague desde o cursor até o final da linha.
CtrlU	Apague desde o cursor até o início da linha.
CtrlW	Exclua a palavra anterior.
Início	Mova para o início da linha atual.
End	Mova para o final da linha atual.
CtrlCasa	Vá para o início do texto.
CtrlFim	Mova para o final do texto.
Meta←→	Mova o cursor uma palavra por vez.
↑↓	Navegue pelo histórico de comandos.

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).
,	Habilite todas as permissões (ferramentas, caminhos e URLs).
,	Limpe o histórico da conversa.
/compact	Resumir o histórico de conversas para reduzir o uso da janela de contexto.
/context	Mostrar o uso e a visualização do token da janela de contexto.
,	Altere o diretório de trabalho ou exiba o diretório atual.
/delegate [PROMPT]	Delegar alterações em um repositório remoto com uma solicitação de pull gerada por IA.
/diff	Examine as alterações feitas no diretório atual.
,	Saia da CLI.
/experimental [on|off]	Ative ou desative as funcionalidades experimentais.
/feedback	Forneça comentários sobre a CLI.
/fleet [PROMPT]	Habilite a execução de subagentes paralelos de partes de uma tarefa. Confira AUTOTITLE.
/help	Mostrar a ajuda para comandos interativos.
/ide	Conecte-se a um workspace do IDE.
/init	Inicialize as instruções personalizadas Copilot e recursos de agente para este repositório.
/list-dirs	Exiba todos os diretórios para os quais o acesso ao arquivo foi permitido.
/login	Faça login no Copilot.
/logout	Sair de Copilot.
/lsp [show|test|reload|help] [SERVER-NAME]	Gerencie a configuração do servidor de idiomas.
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME]	Gerenciar a configuração do servidor MCP.
,	Selecione o modelo de IA que você deseja usar.
/plan [PROMPT]	Crie um plano de implementação antes da codificação.
/plugin [marketplace|install|uninstall|update|list] [ARGS...]	Gerenciar plug-ins e mercados de plug-ins.
/rename NAME	Renomeie a sessão atual (pseudônimo de ).
/reset-allowed-tools	Redefina a lista de ferramentas permitidas.
/resume [SESSION-ID]	Alterne para uma sessão diferente escolhendo em uma lista (opcionalmente, especifique uma ID de sessão).
/review [PROMPT]	Execute o agente de revisão de código para analisar as alterações.
/session [checkpoints [n]|files|plan|rename NAME]	Mostrar informações de sessão e um resumo do workspace. Use os subcomandos para obter detalhes.
/share [file|gist] [PATH]	Compartilhe a sessão em um arquivo markdown ou GitHub gist.
/skills [list|info|add|remove|reload] [ARGS...]	Gerenciar habilidades para funcionalidades aprimoradas.
/terminal-setup	Configure o terminal para suporte de entrada multilinha (ShiftEnter e CtrlEnter).
/theme [show|set|list] [auto|THEME-ID]	Exibir ou configurar o tema do terminal.
/usage	Exibir estatísticas e métricas de uso de sessão.
/user [show|list|switch]	Gerencie o usuário GitHub atual.

Para obter uma lista completa dos comandos slash disponíveis, insira 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 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 . 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-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: ).
--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 ( ou ).
--autopilot	Habilite a continuação do piloto automático no modo de prompt. Confira AUTOTITLE.
--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 para shells bash ( ou ).
--config-dir PATH	Defina o diretório de configuração (padrão: ).
--continue	Retome a sessão mais recente.
--deny-tool [TOOLS...]	Ferramentas que a CLI não tem permissão para usar. Não solicitará permissão.
--deny-url [URLS...]	Negar acesso a URLs ou domínios específicos, tem precedência sobre .
--disable-builtin-mcps	Desabilitar todos os servidores MCP internos (atualmente: ).
--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 e .
--excluded-tools [TOOLS...]	Essas ferramentas não estarão disponíveis para o modelo.
--experimental	Habilitar recursos experimentais (use para desabilitar).
,	Exibir ajuda.
,	Inicie uma sessão interativa e execute esse prompt automaticamente.
--log-dir DIRECTORY	Defina o diretório do arquivo de log (padrão: ).
--log-level LEVEL	Defina o nível de log (opções: , , , , , , , ).
--max-autopilot-continues COUNT	Número máximo de mensagens de continuação no modo de piloto automático (padrão: ilimitado). Confira AUTOTITLE.
--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 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 para shells bash.
--no-color	Desative toda a saída de cor.
--no-custom-instructions	Desabilite o carregamento de instruções personalizadas de e arquivos relacionados.
--no-experimental	Desabilitar recursos experimentais.
,	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).
,	Gerar somente a resposta do agente (sem estatísticas de uso), útil para scripts com .
--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: ).
--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: ou ).
,	Mostrar informações de versão.
--yolo	Habilitar todas as permissões (equivalente a ).

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

Padrões de permissão de ferramenta

As opções e aceitam padrões de permissão no formato . 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	, ,
write	Criação ou modificação de arquivo	,
read	Leituras de arquivo ou diretório	,
SERVER-NAME	Invocação da ferramenta de servidor MCP	,
url	Acesso à URL por meio de web-fetch ou shell	,
memory	Armazenando fatos na memória do agente	memory

Para as regras, o sufixo corresponde ao comando principal seguido por um espaço, impedindo correspondências parciais. Por exemplo, corresponde e não corresponde .

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

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-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 permitir todas as permissões automaticamente (equivalente a ).
COPILOT_AUTO_UPDATE	Defina como 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 e ). Assume o valor padrão de se nenhum for definido.
COPILOT_GITHUB_TOKEN	Token de autenticação. Tem precedência sobre e .
GH_TOKEN	Token de autenticação. Tem precedência sobre .
GITHUB_TOKEN	Token de autenticação.
XDG_CONFIG_HOME	Substitua o diretório de configuração. Padrão: .
XDG_STATE_HOME	Substitua o diretório de estado. Padrão: .
USE_BUILTIN_RIPGREP	Defina como para usar o ripgrep do sistema em vez da versão agrupada.
PLAIN_DIFF	Definir para 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, ).

Configurações do arquivo de configuração

As configurações do usuário são armazenadas em . Configurações no nível de projeto podem ser colocadas em confirmadas no repositório ou em como substituições pessoais—adicionar a . 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.
bash_env	boolean	false	Habilite suporte para em shells bash.
beep	boolean	true	Reproduza um bipe audível quando a atenção é necessária.
compact_paste	boolean	true	Compactar conteúdos grandes em tokens compactos.
custom_agents.default_local_only	boolean	false	Use apenas agentes personalizados locais.
denied_urls	string[]	[]	URLs ou domínios bloqueados (tem precedência sobre ).
experimental	boolean	false	Habilitar recursos experimentais.
include_coauthor	boolean	true	Adicione um trailer às confirmações do git feitas pelo agente.
launch_messages	string[]	[]	Mensagens personalizadas mostradas aleatoriamente na inicialização.
log_level	"none" | "error" | "warning" | "info" | "debug" | "all" | "default"	"default"	Verbosidade de registro em log.
model	string	varies	Modelo de IA a ser usado (consulte o comando).
reasoning_effort	"low" | "medium" | "high" | "xhigh"	"medium"	Nível de esforço de raciocínio para o pensamento aprofundado. Níveis mais altos usam mais computação.
render_markdown	boolean	true	Renderizar Markdown na saída do terminal.
screen_reader	boolean	false	Habilitar otimizações de leitor de tela.
stream	boolean	true	Habilitar respostas de streaming.
store_token_plaintext	boolean	false	Armazene tokens de autenticação em texto não criptografado no arquivo de configuração quando nenhum conjunto de chaves do sistema estiver disponível.
streamer_mode	boolean	false	Ocultar nomes de modelos de pré-visualização e detalhes de cotas (o que é útil ao gravar).
theme	"auto" | "dark" | "light"	"auto"	Tema de cor do terminal.
trusted_folders	string[]	[]	Pastas com acesso a arquivos pré-autorizado.
update_terminal_title	boolean	true	Mostrar a intenção atual no título do terminal.

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 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 :

{
  "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 .
bash	cadeia	Um dos	Comando shell para Unix.
powershell	cadeia	Um dos	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: .

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

controle de decisão

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

Campo	Valores	DESCRIÇÃO
permissionDecision	, ,	Se a ferramenta é executada. A saída vazia usa o comportamento padrão.
permissionDecisionReason	cadeia	Motivo mostrado ao agente. Obrigatório quando a decisão é .
modifiedArgs	objeto	Substitua os argumentos da ferramenta para serem usados no lugar dos originais.

controle de decisão

Campo	Valores	DESCRIÇÃO
decision	,	obriga outro agente a fazer um turno usando como prompt.
reason	cadeia	Solicite a próxima rodada quando for .

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 , se algum gancho retornar , 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 . Use 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.	,
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 , e 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	ou . Padrão: .

Campos de configuração de servidor remoto

Campo	Obrigatório	DESCRIÇÃO
type	Yes	ou .
url	Yes	URL do servidor.
tools	Yes	Ferramentas para habilitar.
headers	Não	Cabeçalhos HTTP. Dá suporte à expansão variável.
oauthClientId	Não	ID do cliente OAuth estático (ignora o registro dinâmico).
oauthPublicClient	Não	Se o cliente OAuth é público. Padrão: .
timeout	Não	Tempo limite de chamada de ferramenta em milissegundos.

Mapeamento de filtro

Controlar como a saída da ferramenta MCP é processada usando o 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 .
time	Utilitários de tempo: e .

Use para desabilitar todos os servidores internos ou 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 arquivo. Quando invocado (via 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 . Padrão: .
disable-model-invocation	boolean	Não	Impedir que o agente invoque automaticamente essa habilidade. Padrão: .

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	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 em . O nome do comando é derivado do nome do arquivo. Os arquivos de comando usam um formato simplificado (nenhum campo necessário) e dão suporte , e . 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 ou como a extensão de arquivo.

Agentes integrados

Agente	Modelo padrão	DESCRIÇÃO
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.
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.
general-purpose	claude-sonnet-4.5	Agente de funcionalidade completa para tarefas complexas de várias etapas. É executado em uma janela de contexto separada.
research	claude-sonnet-4.6	Agente de pesquisa profunda. Gera um relatório com base em informações em sua base de código, em repositórios relevantes e na Web.
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.

Campos de frontmatter personalizados do agente

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

Locais do agente personalizado

Scope	Localização
Projeto	ou
Usuário	ou
Plug-in	<plugin>/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 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.