Diretório de configuração da CLI do GitHub Copilot

          CLI do Copilot armazena sua configuração, histórico de sessão, logs e personalizações em um único diretório em seu computador. Por padrão, esse diretório é `~/.copilot` (ou seja, `$HOME/.copilot`).

Este artigo descreve o conteúdo deste diretório e como você pode usá-los.

Visão geral do diretório

O ~/.copilot diretório contém os seguintes itens de nível superior.

Caminho	Tipo	Descrição
`config.json`	Arquivo	Suas configurações pessoais
`mcp-config.json`	Arquivo	Definições de servidor MCP no nível do usuário
`permissions-config.json`	Arquivo	Permissões de ferramenta e diretório salvas por projeto
`agents/`	Diretório	Definições de agente personalizado pessoal
`skills/`	Diretório	Definições de habilidades personalizadas pessoais
`hooks/`	Diretório	Scripts de gancho no nível do usuário
`logs/`	Diretório	Arquivos de log de sessão
`session-state/`	Diretório	Histórico de sessão e dados do workspace
`session-store.db`	Arquivo	Banco de dados SQLite para dados entre sessões
`installed-plugins/`	Diretório	Arquivos de plug-in instalados
`ide/`	Diretório	Estado de integração do IDE

Observação

Nem todos esses itens aparecem imediatamente. Alguns são criados sob demanda na primeira vez que você usa um recurso específico— por exemplo, installed-plugins/ aparece somente depois de instalar seu primeiro plug-in.

Arquivos editáveis pelo usuário

Os arquivos a seguir foram projetados para serem editados diretamente por você ou gerenciados por meio de comandos da CLI.

`config.json`

Este é o arquivo de configuração principal para CLI do Copilot. Você pode editá-lo diretamente em um editor de texto ou usar comandos interativos como /model e /theme alterar valores específicos de dentro de uma sessão. O arquivo dá suporte a JSON com comentários (JSONC).

As configurações comuns incluem:

Chave	Tipo	Descrição
`model`	cadeia	Modelo de IA a ser usado (por exemplo, `"gpt-5.2"`, ) `"claude-sonnet-4.6"`
`effortLevel`	cadeia	Nível de esforço de raciocínio para modelos que o suportam
`theme`	cadeia	Tema de cor: `"auto"`, `"dark"`ou `"light"`
`alt_screen`	boolean	Use o buffer de tela alternativo (padrão: `true`)
`mouse`	boolean	Habilitar o suporte ao mouse no modo de tela alt (padrão: `true`)
`banner`	cadeia	Frequência de banner animado: `"always"`, `"once"`, ou `"never"` (padrão: `"once"`)
`render_markdown`	boolean	Renderizar markdown em respostas (padrão: `true`)
`screen_reader`	boolean	Habilitar otimizações de leitor de tela (padrão: `false`)
`auto_update`	boolean	Baixe automaticamente as atualizações da CLI (padrão: `true`)
`stream`	boolean	Transmissão de respostas token por token (padrão: `true`)
`includeCoAuthoredBy`	boolean	Adicionar "Co-authored-by" a commits criados pelo agente (padrão: `true`)
`respectGitignore`	boolean	Excluir arquivos ignorados pelo git do seletor de arquivos `@` (padrão: `true`)
`trusted_folders`	cadeia de caracteres[]	Pastas em que a permissão de leitura/execução foi concedida
`allowed_urls`	cadeia de caracteres[]	URLs ou domínios permitidos sem solicitação
`denied_urls`	cadeia de caracteres[]	URLs ou domínios sempre bloqueados
`log_level`	cadeia	Verbosidade de log: `"none"`, `"error"`, `"warning"`, `"info"`, `"debug"`, `"all"` ou `"default"` (padrão: `"default"`)
`disableAllHooks`	boolean	Desabilitar todos os ganchos (padrão: `false`)
`hooks`	objeto	Definições de ganchos em linha no nível do usuário

Para obter uma lista completa das configurações, insira copilot help config no terminal.

Dica

Algumas configurações também podem ser definidas usando sinalizadores de linha de comando. Por exemplo, --alt-screen e --no-alt-screen definem o valor de alt_screen e o persistem em config.json. O /model comando de barra grava sua seleção de modelo nesse arquivo para que ele persista entre as sessões.

`mcp-config.json`

Define os servidores MCP (Protocolo de Contexto de Modelo) disponíveis no nível do usuário. Esses servidores estão disponíveis em todas as suas sessões, independentemente de qual diretório de projeto você esteja. As configurações de MCP no nível do projeto (em .mcp.json, .github/mcp.json ou .vscode/mcp.json) têm precedência sobre definições no nível do usuário quando os nomes do servidor entram em conflito.

Para obter mais informações, consulte Adicionando servidores MCP para CLI do GitHub Copilot.

`agents/`

Armazene as definições de agente personalizado pessoal aqui como .agent.md arquivos. Os agentes colocados neste diretório estão disponíveis em todas as suas sessões. Os agentes no nível do projeto (em .github/agents/) têm precedência sobre agentes pessoais se compartilharem o mesmo nome.

Para obter mais informações, consulte Criando e usando agentes personalizados para CLI do GitHub Copilot.

`skills/`

Armazene as definições de habilidades personalizadas pessoais aqui. Cada habilidade reside em um subdiretório que contém um SKILL.md arquivo, por exemplo, ~/.copilot/skills/my-skill/SKILL.md. As habilidades pessoais estão disponíveis em todas as suas sessões. As habilidades no nível do projeto têm precedência sobre as habilidades pessoais se compartilharem o mesmo nome.

Para obter mais informações, consulte Criando habilidades de agente para CLI do GitHub Copilot.

`hooks/`

Armazene scripts de gancho no nível do usuário aqui. Esses ganchos se aplicam a todas as suas sessões. Você também pode definir ganchos embutidos no config.json usando a chave hooks. Os ganchos no nível do repositório (in .github/hooks/) são carregados junto com ganchos no nível do usuário.

Para obter mais informações, consulte Usando ganchos com CLI do GitHub Copilot.

Arquivos gerenciados automaticamente

Os itens a seguir são gerenciados pela CLI. Você geralmente não deve editá-los manualmente.

`permissions-config.json`

Armazena as suas decisões de permissão de ferramenta e diretório salvas, organizadas pelo local do projeto. Quando você aprova uma ferramenta ou concede acesso a um diretório, a CLI registra a decisão aqui para que você não seja solicitado novamente no mesmo projeto.

Observação

Se você quiser redefinir permissões para um projeto, poderá excluir a entrada relevante desse arquivo. No entanto, editar o arquivo enquanto uma sessão está em execução pode causar um comportamento inesperado.

`session-state/`

Contém dados de histórico de sessão, organizados por ID de sessão em subdiretórios. Cada diretório de sessão armazena um log de eventos (events.jsonl) e artefatos de workspace (planos, pontos de verificação, arquivos rastreados). Esses dados permitem que a sessão seja retomada (--resume ou --continue).

`session-store.db`

Um banco de dados SQLite usado pela CLI para armazenamento de dados entre sessões, como indexação e buscas de checkpoints. Esse arquivo é gerenciado automaticamente e não deve ser editado.

`logs/`

Contém arquivos de log para sessões da CLI. Cada sessão cria um arquivo de log chamado process-{timestamp}-{pid}.log. Esses arquivos são úteis na depuração de problemas.

Dica

Para localizar o arquivo de log da sessão atual, insira /session em uma sessão interativa. A saída inclui o caminho completo para o arquivo de log, juntamente com outros detalhes da sessão, como a ID da sessão, a duração e o diretório de trabalho.

`installed-plugins/`

Contém os arquivos para plug-ins instalados. Os plug-ins instalados de um marketplace são armazenados em installed-plugins/{marketplace-name}/{plugin-name}/. Os plug-ins instalados diretamente são armazenados em installed-plugins/_direct/. Gerencie plug-ins usando os copilot plugin comandos em vez de editar esse diretório diretamente.

Para obter mais informações, consulte Referência do plugin CLI do GitHub Copilot.

`ide/`

Contém arquivos de bloqueio e estado para integrações de IDE (por exemplo, quando CLI do Copilot se conecta a Visual Studio Code). Esse diretório é gerenciado automaticamente.

Alterando o local do diretório de configuração

Você pode substituir o local padrão ~/.copilot de duas maneiras:

        **Variável de ambiente**: defina `COPILOT_HOME` como o caminho do diretório que você deseja usar.

Bash

export COPILOT_HOME=/path/to/my/copilot-config

export COPILOT_HOME=/path/to/my/copilot-config

        **Opção de linha de comando**: use `--config-dir` ao iniciar a CLI.