Directorio de configuración de la CLI de Copilot de GitHub

          CLI de Copilot almacena su configuración, historial de sesión, registros y personalizaciones en un único directorio de la máquina. De forma predeterminada, este directorio es `~/.copilot` (es decir, `$HOME/.copilot`).

En este artículo se describe el contenido de este directorio y cómo se pueden usar.

Introducción al directorio

El ~/.copilot directorio contiene los siguientes elementos de nivel superior.

Camino	Tipo	Descripción
`config.json`	Archivo	Las opciones de configuración personal
`mcp-config.json`	Archivo	Definiciones de servidor MCP de nivel de usuario
`permissions-config.json`	Archivo	Herramientas guardadas y permisos de directorio por proyecto
`agents/`	Directorio	Definiciones de agente personalizado personal
`skills/`	Directorio	Definiciones de aptitudes personalizadas personales
`hooks/`	Directorio	Scripts de enlace de nivel de usuario
`logs/`	Directorio	Archivos de registro de sesión
`session-state/`	Directorio	Historial de sesiones y datos del área de trabajo
`session-store.db`	Archivo	Base de datos de SQLite para datos entre sesiones
`installed-plugins/`	Directorio	Archivos de complemento instalados
`ide/`	Directorio	Estado de integración del IDE

Nota:

No todos estos elementos aparecen inmediatamente. Algunas se crean a petición la primera vez que se usa una característica determinada; por ejemplo, installed-plugins/ solo aparece después de instalar el primer complemento.

Archivos editables por el usuario

Los siguientes archivos están diseñados para que los edite directamente o se administren mediante comandos de la CLI.

`config.json`

Este es el archivo de configuración principal de CLI de Copilot. Puede editarlo directamente en un editor de texto o usar comandos interactivos como /model y /theme para cambiar valores específicos desde dentro de una sesión. El archivo admite JSON con comentarios (JSONC).

Entre las opciones comunes se incluyen:

Key	Tipo	Descripción
`model`	cuerda / cadena	Modelo de IA que se va a usar (por ejemplo, `"gpt-5.2"`, `"claude-sonnet-4.6"`)
`effortLevel`	cuerda / cadena	Nivel de esfuerzo de razonamiento para modelos que lo admiten
`theme`	cuerda / cadena	Tema de color: `"auto"`, `"dark"`o `"light"`
`alt_screen`	boolean	Use el búfer de pantalla alternativo (valor predeterminado: `true`)
`mouse`	boolean	Habilitar la compatibilidad con el mouse en el modo de pantalla alternativo (valor predeterminado: `true`)
`banner`	cuerda / cadena	Frecuencia de banner animada: `"always"`, `"once"`o `"never"` (valor predeterminado: `"once"`)
`render_markdown`	boolean	Mostrar markdown en las respuestas (valor predeterminado: `true`)
`screen_reader`	boolean	Habilitación de las optimizaciones del lector de pantalla (valor predeterminado: `false`)
`auto_update`	boolean	Descargar automáticamente las actualizaciones de la CLI (valor predeterminado: `true`)
`stream`	boolean	Transmitir respuestas token por token (valor predeterminado: `true`)
`includeCoAuthoredBy`	boolean	Agregar co-autoría a confirmaciones creadas por agente (valor predeterminado: `true`)
`respectGitignore`	boolean	Excluya los archivos gitignored del `@` selector de archivos (valor predeterminado: `true`)
`trusted_folders`	string[]	Carpetas en las que se ha concedido el permiso de lectura y ejecución
`allowed_urls`	string[]	URL o dominios permitidos sin necesidad de consulta
`denied_urls`	string[]	Direcciones URL o dominios que siempre están denegados
`log_level`	cuerda / cadena	Detalle del registro: `"none"`, `"error"`, `"warning"`, `"info"`, `"debug"`, o `"all"`, `"default"` (valor predeterminado: `"default"`)
`disableAllHooks`	boolean	Deshabilitar todos los ganchos (valor predeterminado: `false`)
`hooks`	objeto	Definiciones de enlace de nivel de usuario insertadas

Para obtener una lista completa de las opciones de configuración, escriba copilot help config en el terminal.

Sugerencia

Algunas opciones de configuración también se pueden establecer mediante marcas de línea de comandos. Por ejemplo, --alt-screen y --no-alt-screen establecen el valor de alt_screen y lo almacenen en config.json. El /model comando de barra diagonal escribe la selección del modelo en este archivo para que persista entre sesiones.

`mcp-config.json`

Define los servidores MCP (Protocolo de contexto de modelo) disponibles en el nivel de usuario. Estos servidores están disponibles en todas las sesiones, independientemente del directorio del proyecto en el que esté. Las configuraciones de MCP de nivel de proyecto (en .mcp.json, .github/mcp.json o .vscode/mcp.json) tienen prioridad sobre las definiciones de nivel de usuario cuando los nombres de servidor entran en conflicto.

Para obtener más información, vea Adición de servidores MCP para la CLI de GitHub Copilot.

`agents/`

Almacene las definiciones de agentes personalizados personales aquí como .agent.md archivos. Los agentes colocados en este directorio están disponibles en todas las sesiones. Los agentes de nivel de proyecto (en .github/agents/) tienen prioridad sobre los agentes personales si comparten el mismo nombre.

Para obtener más información, vea Creación y uso de agentes personalizados para CLI de GitHub Copilot.

`skills/`

Almacene las definiciones de aptitudes personalizadas personales aquí. Cada aptitud reside en un subdirectorio que contiene un SKILL.md archivo, por ejemplo, ~/.copilot/skills/my-skill/SKILL.md. Las habilidades personales están disponibles en todas tus sesiones. Las aptitudes de nivel de proyecto tienen prioridad sobre las aptitudes personales si comparten el mismo nombre.

Para obtener más información, vea Creación de aptitudes de agente para CLI de GitHub Copilot.

`hooks/`

Almacene los scripts de enlace de nivel de usuario aquí. Estos ganchos se aplican a todas las sesiones. También puede definir hooks en línea en config.json mediante la tecla hooks. Los enlaces de nivel de repositorio (en .github/hooks/) se cargan junto con enlaces de nivel de usuario.

Para obtener más información, vea Uso de enlaces con CLI de GitHub Copilot.

Archivos administrados automáticamente

La CLI administra los siguientes elementos. Por lo general, no debe editarlos manualmente.

`permissions-config.json`

Almacena las decisiones de permisos de directorio y herramienta guardadas, organizadas por ubicación del proyecto. Al aprobar una herramienta o conceder acceso a un directorio, la CLI registra la decisión aquí para que no se le solicite de nuevo en el mismo proyecto.

Nota:

Si desea restablecer los permisos de un proyecto, puede eliminar la entrada pertinente de este archivo. Sin embargo, la edición del archivo mientras se ejecuta una sesión puede provocar un comportamiento inesperado.

`session-state/`

Contiene datos del historial de sesión, organizados por identificador de sesión en subdirectorios. Cada directorio de sesión almacena un registro de eventos (events.jsonl) y artefactos del área de trabajo (planes, puntos de control, archivos de seguimiento). Estos datos habilitan el reanudación de sesión (--resume o --continue).

`session-store.db`

Una base de datos de SQLite usada por la CLI para datos entre sesiones, como la indexación y la búsqueda de puntos de comprobación. Este archivo se administra automáticamente y no se debe editar.

`logs/`

Contiene archivos de registro para las sesiones de la CLI. Cada sesión crea un archivo de registro denominado process-{timestamp}-{pid}.log. **
Estos archivos son útiles para depurar problemas.

Sugerencia

Para buscar el archivo de registro de la sesión actual, escriba /session en una sesión interactiva. La salida incluye la ruta de acceso completa al archivo de registro, junto con otros detalles de la sesión, como el identificador de sesión, la duración y el directorio de trabajo.

`installed-plugins/`

Contiene los archivos de los complementos que ha instalado. Los complementos instalados desde marketplace se almacenan en installed-plugins/{marketplace-name}/{plugin-name}/. Los complementos instalados directamente se almacenan en installed-plugins/_direct/. Administre complementos mediante los copilot plugin comandos en lugar de editar este directorio directamente.

Para obtener más información, vea Referencia del complemento de la CLI de Copilot de GitHub.

`ide/`

Contiene archivos de bloqueo y estado para las integraciones del IDE (por ejemplo, cuando CLI de Copilot se conecta a Visual Studio Code). Este directorio se administra automáticamente.

Cambio de la ubicación del directorio de configuración

Puede invalidar la ubicación predeterminada ~/.copilot de dos maneras:

        **Variable de entorno**: establezca `COPILOT_HOME` en la ruta de acceso del directorio que desea usar.

Bash

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

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

        **Opción de línea de comandos**: use `--config-dir` al iniciar la CLI.