Referencia de comandos de la CLI de Copilot de GitHub

Comandos de la línea de comandos

Command	Propósito
`copilot`	Inicie la interfaz de usuario interactiva.
`copilot help [topic]`	Mostrar información de ayuda. Los temas de ayuda incluyen: `config`, `commands`, `environment`, `logging`y `permissions`.
`copilot init`	Inicialice las instrucciones personalizadas de Copilot para este repositorio.
`copilot update`	Descargue e instale la versión más reciente.
`copilot version`	Mostrar información de versión y comprobar si hay actualizaciones.
`copilot login`	Autentíquese con Copilot a través del flujo del dispositivo OAuth.

          `--host HOST` Acepta especificar la dirección URL de host GitHub (valor predeterminado: `https://github.com`). |

Accesos directos globales en la interfaz interactiva

Shortcut	Propósito
`@ FILENAME`	Incluya el contenido del archivo en el contexto.

          <kbd>Ctrl</kbd>+<kbd>X</kbd> después `/`  | Después de empezar a escribir un mensaje, esto le permite ejecutar un comando de barra, por ejemplo, si desea cambiar el modelo sin tener que volver a escribir el mensaje. |

Accesos directos de escala de tiempo en la interfaz interactiva

Shortcut	Propósito
ctrl+o	Aunque no hay nada en la entrada de la solicitud, esto expande los elementos recientes de la escala de tiempo de respuesta de Copilot para mostrar más detalles.
Ctrl+E	Aunque no hay nada en la entrada de la solicitud, esto expande todos los elementos de la escala de tiempo de respuesta de Copilot.
ctrl+t	Expandir o contraer la visualización del razonamiento en las respuestas.

Shortcut	Propósito

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | Ir al principio de la línea (al escribir). |

Comandos de barra en la interfaz interactiva

Command	Propósito
`/add-dir PATH`	Agregue un directorio a la lista de permitidos para el acceso a archivos.
`/agent`	Examine y seleccione entre los agentes disponibles (si los hay).

          `/allow-all`, `/yolo`                               | Habilite todos los permisos (herramientas, rutas de acceso y direcciones URL). |

Para obtener una lista completa de los comandos de barra diagonal disponibles, escriba /help en la interfaz interactiva de la CLI.

Opciones de la línea de comandos

Opción	Propósito
`--acp`	Inicie el servidor del Protocolo de Cliente del Agente.
`--add-dir PATH`	Agregue un directorio a la lista de permitidos para el acceso a archivos (se puede usar varias veces).
`--add-github-mcp-tool TOOL`	Agregar una herramienta para habilitar el servidor MCP de GitHub, en lugar del subconjunto predeterminado de la CLI (puede usarse varias veces). Utilice `*` para todas las herramientas.
`--add-github-mcp-toolset TOOLSET`	Agregue un conjunto de herramientas para habilitar para GitHub servidor MCP, en lugar del subconjunto predeterminado de la CLI (se puede usar varias veces). Use `all` para todos los conjuntos de herramientas.
`--additional-mcp-config JSON`	Agregue un servidor MCP solo para esta sesión. La configuración del servidor se puede proporcionar como una cadena JSON o una ruta de acceso de archivo (prefijo con `@`). Amplía la configuración de `~/.copilot/mcp-config.json`. Invalida cualquier configuración de servidor MCP instalada con el mismo nombre.
`--agent AGENT`	Especificar el uso de un agente personalizado.
`--allow-all`	Habilite todos los permisos (equivalentes a `--allow-all-tools --allow-all-paths --allow-all-urls`).
`--allow-all-paths`	Deshabilite la comprobación de la ruta de acceso del archivo y permita el acceso a cualquier ruta de acceso.
`--allow-all-tools`	Permitir que todas las herramientas se ejecuten automáticamente sin confirmación. Necesario cuando se usa la CLI mediante programación (env: `COPILOT_ALLOW_ALL`).
`--allow-all-urls`	Permitir el acceso a todas las direcciones URL sin confirmación.
`--allow-tool [TOOLS...]`	Herramientas que la CLI tiene permiso para usar. No solicitará permiso.
`--allow-url [URLS...]`	Permitir el acceso a direcciones URL o dominios específicos.
`--alt-screen [VALUE]`	Use el búfer de pantalla alternativo del terminal (`on` o `off`).
`--autopilot`	Habilite la continuación del piloto automático en modo aviso. Consulta Permitir que la CLI de GitHub Copilot funcione de forma autónoma.
`--available-tools [TOOLS...]`	Solo estas herramientas estarán disponibles para el modelo.
`--banner`	Muestra el banner de inicio.
`--bash-env [VALUE]`	Habilite la compatibilidad de `BASH_ENV` con shells de Bash (`on` o `off`).
`--config-dir PATH`	Establezca el directorio de configuración (valor predeterminado: `~/.copilot`).
`--continue`	Reanude la sesión más reciente.
`--deny-tool [TOOLS...]`	Herramientas que la CLI no tiene permiso para usar. No solicitará permiso.
`--deny-url [URLS...]`	Denegar el acceso a direcciones URL o dominios específicos tiene prioridad sobre `--allow-url`.
`--disable-builtin-mcps`	Deshabilite todos los servidores MCP integrados (actualmente: `github-mcp-server`).
`--disable-mcp-server SERVER-NAME`	Deshabilite un servidor MCP específico (se puede usar varias veces).
`--disable-parallel-tools-execution`	Deshabilite la ejecución en paralelo de las herramientas (LLM todavía puede realizar llamadas a herramientas paralelas, pero se ejecutarán secuencialmente).
`--disallow-temp-dir`	Impedir el acceso automático al directorio temporal del sistema.
`--enable-all-github-mcp-tools`	Habilite todas las herramientas de servidor MCP GitHub en lugar del subconjunto predeterminado de la CLI. Invalida las opciones `--add-github-mcp-toolset` y `--add-github-mcp-tool`.
`--excluded-tools [TOOLS...]`	Estas herramientas no estarán disponibles para el modelo.
`--experimental`	Habilite las características experimentales (use `--no-experimental` para deshabilitar).

          `-h`, `--help`                     | Mostrar ayuda. |

| -i PROMPT, --interactive PROMPT | Inicie una sesión interactiva y ejecute automáticamente esta solicitud. | | --log-dir DIRECTORY | Establezca el directorio del archivo de registro (valor predeterminado: ~/.copilot/logs/). | | --log-level LEVEL | Configure el nivel de registro (opciones: none, error, warning, info, debug, all, default). | | --max-autopilot-continues COUNT | Número máximo de mensajes de continuación en el modo autopilot (valor predeterminado: ilimitado). Consulta Permitir que la CLI de GitHub Copilot funcione de forma autónoma. | | --model MODEL | Establezca el modelo de IA que desea usar. | | --no-alt-screen | Deshabilite el búfer de pantalla alternativo del terminal. | | --no-ask-user | Deshabilite la ask_user herramienta (el agente funciona de forma autónoma sin formular preguntas). | | --no-auto-update | Deshabilite la descarga automática de actualizaciones de la CLI. | | --no-bash-env | Deshabilite la compatibilidad de BASH_ENV con los shells de Bash. | | --no-color | Deshabilite toda la salida de color. | | --no-custom-instructions | Deshabilite la carga de instrucciones personalizadas desde AGENTS.md y archivos relacionados. | | --no-experimental | Desactivar las funciones experimentales. | | -p PROMPT, --prompt PROMPT | Ejecute un comando programáticamente (se cierra al finalizar). | | --plain-diff | Deshabilitar la representación de diferencias enriquecidas (resaltado de sintaxis mediante la herramienta de diferencias especificada por la configuración de Git). | | --resume [SESSION-ID] | Reanude una sesión interactiva anterior eligiendo entre una lista (opcionalmente, especifique un identificador de sesión). | | -s, --silent | Genera solo la respuesta del agente (sin estadísticas de uso), útil para el scripting con -p. | | --screen-reader | Habilite las optimizaciones del lector de pantalla. | | --share [PATH] | Comparta una sesión en un archivo Markdown después de completar una sesión programática (ruta de acceso predeterminada: ./copilot-session-<ID>.md). | | --share-gist | Compartir una sesión en un gist secreto de GitHub después de completar una sesión programática. | | --stream MODE | Habilite o deshabilite el modo de streaming (opciones de modo: on o off). | | -v, --version | Mostrar información de versión. | | --yolo | Habilite todos los permisos (equivalentes a --allow-all). |

Para obtener una lista completa de comandos y opciones, ejecute copilot help.

Patrones de permisos de herramientas

Las --allow-tool opciones y --deny-tool aceptan patrones de permisos con el formato Kind(argument). El argumento es opcional: si se omite, coincide con todas las herramientas de ese tipo.

Tipo	Description	Patrones de ejemplo
`shell`	Ejecución de comandos de Shell

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

| write | Creación o modificación de archivos | write, write(src/*.ts) | | read | Lecturas de archivos o directorios | read, read(.env) | | SERVER-NAME | Invocación de la herramienta de servidor MCP | MyMCP(create_issue), MyMCP | | url | Acceso a la URL a través de web-fetch o shell | url(github.com), url(https://*.api.com) | | memory | Almacenamiento de hechos en la memoria del agente | memory |

Para las reglas de shell, el sufijo :* coincide con la raíz del comando seguido de un espacio, evitando coincidencias parciales. Por ejemplo, shell(git:*) coincide con git push y git pull, pero no coincide con gitea.

Las reglas de denegación siempre tienen prioridad sobre las reglas de autorización, incluso cuando --allow-all está configurado.

# 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'

Variables de entorno

Variable	Description
`COPILOT_MODEL`	Establezca el modelo de IA.
`COPILOT_ALLOW_ALL`	Establézcalo en `true` para permitir todos los permisos automáticamente (equivalente a `--allow-all`).
`COPILOT_AUTO_UPDATE`	Establézcalo en `false` para deshabilitar las actualizaciones automáticas.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	Lista separada por comas de directorios adicionales para obtener instrucciones personalizadas.
`COPILOT_SKILLS_DIRS`	Lista de directorios adicionales separada por comas para habilidades.
`COPILOT_EDITOR`	Comando del editor para la edición interactiva (activada después de `$VISUAL` y `$EDITOR`). El valor predeterminado es `vi` si no se establece ninguno.
`COPILOT_GITHUB_TOKEN`	Token de autenticación. Tiene prioridad sobre `GH_TOKEN` y `GITHUB_TOKEN`.
`GH_TOKEN`	Token de autenticación. Tiene prioridad sobre `GITHUB_TOKEN`.
`GITHUB_TOKEN`	Token de autenticación.
`XDG_CONFIG_HOME`	Invalide el directorio de configuración. Predeterminado: `$HOME/.copilot`.
`XDG_STATE_HOME`	Invalide el directorio de estado. Predeterminado: `$HOME/.copilot`.
`USE_BUILTIN_RIPGREP`	Establézcalo en `false` para usar el ripgrep del sistema en lugar de la versión incluida.
`PLAIN_DIFF`	Establézcalo en `true` para deshabilitar la representación de diferencias enriquecidas.
`COLORFGBG`	Solución alternativa para la detección de fondo oscuro/claro del terminal.
`COPILOT_CLI_ENABLED_FEATURE_FLAGS`	Lista separada por comas de marcas de características que se habilitarán (por ejemplo, `"SOME_FEATURE,SOME_OTHER_FEATURE"`).

Configuración del archivo de configuración

La configuración del usuario se almacena en ~/.copilot/config.json. La configuración de nivel de proyecto se puede colocar en .copilot/settings.json (almacenada en el repositorio) o .copilot/settings.local.json (invalidaciones personales—agregue a .gitignore). La configuración pasa de usuario a proyecto a local, con ámbitos más específicos que reemplazan a más generales. Las marcas de línea de comandos y las variables de entorno siempre tienen la prioridad más alta.

Key	Tipo	Predeterminado	Description
`allowed_urls`	`string[]`	`[]`	Direcciones URL o dominios permitidos sin preguntar.
`alt_screen`	`boolean`	`false`	Use el búfer de pantalla alternativo del terminal.
`auto_update`	`boolean`	`true`	Descargue automáticamente las actualizaciones de la CLI.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | Frecuencia de visualización de banner animado. |

Referencia de enlaces

Los enlaces son comandos externos que se ejecutan en puntos de ciclo de vida específicos durante una sesión, lo que permite la automatización personalizada, los controles de seguridad y las integraciones. Los archivos de configuración de hook se cargan automáticamente desde .github/hooks/*.json de tu repositorio.

Formato de configuración de gancho

Los archivos de configuración de enlace usan el formato JSON con la versión 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	Obligatorio	Description
`type`	`"command"`	Sí	Debe ser `"command"`.
`bash`	cuerda / cadena	Uno de `bash`/`powershell`	Comando shell para Unix.
`powershell`	cuerda / cadena	Uno de `bash`/`powershell`	Comando shell para Windows.
`cwd`	cuerda / cadena	No	Directorio de trabajo para el comando (relativo a la raíz del repositorio o absoluto).
`env`	objeto	No	Variables de entorno que se van a establecer (admite la expansión de variables).
`timeoutSec`	número	No	Tiempo de espera en segundos. Predeterminado: `30`.

Eventos de enlace

Event	Se activa cuando	Salida procesada
`sessionStart`	Comienza una sesión nueva o reanudada.	No
`sessionEnd`	La sesión finaliza.	No
`userPromptSubmitted`	El usuario envía una sugerencia.	No
`preToolUse`	Antes de que se ejecute cada herramienta.	Sí: puede permitir, denegar o modificar.
`postToolUse`	Una vez completada cada herramienta.	No
`agentStop`	El agente principal finaliza un turno.	Sí: puede bloquear y forzar la continuación.
`subagentStop`	Se completa un subagente.	Sí: puede bloquear y forzar la continuación.
`errorOccurred`	Se produce un error durante la ejecución.	No

          `preToolUse` control de decisión

El gancho preToolUse puede controlar la ejecución de la herramienta escribiendo un objeto JSON en la salida estándar (stdout).

Campo	Valores	Description
`permissionDecision`

          `"allow"`, , `"deny"`, `"ask"` | Si se ejecuta la herramienta. La salida vacía usa el comportamiento predeterminado. |

          `agentStop`
           / 
          `subagentStop` control de decisión

Campo	Valores	Description
`decision`

          `"block"`, `"allow"` | 
          `"block"` obliga a otro agente a realizar un turno usando `reason` como solicitud. |

| reason | cuerda / cadena | Solicite el siguiente turno cuando decision sea "block". |

Nombres de herramientas para la coincidencia de ganchos

Nombre de la herramienta	Description
`bash`	Ejecute comandos de shell (Unix).
`powershell`	Ejecute comandos de shell (Windows).
`view`	Leer el contenido del archivo.
`edit`	Modifique el contenido del archivo.
`create`	Cree nuevos archivos.
`glob`	Buscar archivos por patrón.
`grep`	Buscar contenido del archivo.
`web_fetch`	Capturar páginas web.
`task`	Ejecutar tareas de subagentes.

Si se configuran varios ganchos del mismo tipo, se ejecutan en orden. Para preToolUse, si algún gancho devuelve "deny", la herramienta se bloquea. Los errores de enlace (códigos de salida distintos de cero o tiempos de espera) se registran y omiten; nunca bloquean la ejecución del agente.

Configuración del servidor MCP

Los servidores MCP proporcionan herramientas adicionales al agente de la CLI. Configure servidores persistentes en ~/.copilot/mcp-config.json. Use --additional-mcp-config para agregar servidores para una sola sesión.

Tipos de transporte

Tipo	Description	Campos obligatorios
`local` / `stdio`	Proceso local que se comunica a través de stdin/stdout.

          `command`, `args` |

| http | Servidor remoto mediante transporte HTTP transmisible. | url | | sse | Servidor remoto utilizando el transporte de Server-Sent Events. | url |

Campos de configuración del servidor local

Campo	Obligatorio	Description
`command`	Sí	Comando para iniciar el servidor.
`args`	Sí	Argumentos de comando (array).
`tools`	Sí	Herramientas que se van a habilitar: `["*"]` para todos o una lista de nombres de herramientas específicos.
`env`	No	Variables de entorno. Admite `$VAR`, `${VAR}` y `${VAR:-default}` expansión.
`cwd`	No	Directorio de trabajo para el servidor.
`timeout`	No	Tiempo de espera en milisegundos para la llamada a herramienta.
`type`	No

          `"local"` o `"stdio"`. Predeterminado: `"local"`. |

Campos de configuración de servidor remoto

Campo	Obligatorio	Description
`type`	Sí

          `"http"` o `"sse"`. |

Asignación de filtros

Controlar cómo se procesa la salida de la herramienta MCP mediante el filterMapping campo en la configuración de un servidor.

Modo	Description
`none`	Sin filtrado.
`markdown`	Dar formato a la salida como Markdown.
`hidden_characters`	Quite caracteres ocultos o de control. Predeterminado.

Servidores MCP integrados

La CLI incluye servidores MCP integrados que están disponibles sin configuración adicional.

Servidor	Description
`github-mcp-server`	GitHub Integración de API: problemas, solicitudes de incorporación de cambios, confirmaciones, búsqueda de código y GitHub Actions.
`playwright`	Automatización del explorador: navegue, haga clic, escriba, captura de pantalla y control de formularios.
`fetch`	Solicitudes HTTP mediante la herramienta `fetch`.
`time`	Utilidades de tiempo: `get_current_time` y `convert_time`.

Use --disable-builtin-mcps para deshabilitar todos los servidores integrados o --disable-mcp-server SERVER-NAME para deshabilitar uno específico.

Referencia sobre aptitudes

Las aptitudes son archivos markdown que amplían lo que puede hacer la CLI. Cada aptitud reside en su propio directorio que contiene un SKILL.md archivo. Cuando se invoca (a través de /SKILL-NAME o automáticamente por el agente), el contenido de la habilidad se inserta en la conversación.

Campos de frontmatter de habilidades

Campo	Tipo	Obligatorio	Description
`name`	cuerda / cadena	Sí	Identificador único de la aptitud. Solo letras, números y guiones. Máximo de 64 caracteres.
`description`	cuerda / cadena	Sí	Qué hace la aptitud y cuándo usarla. Máximo de 1024 caracteres.
`allowed-tools`	"string" o "string[]"	No	Lista separada por comas o matriz YAML de herramientas que se permiten automáticamente cuando la aptitud está activa. Utilice `"*"` para todas las herramientas.
`user-invocable`	boolean	No	Si los usuarios pueden invocar la aptitud con `/SKILL-NAME`. Predeterminado: `true`.
`disable-model-invocation`	boolean	No	Impedir que el agente invoque automáticamente esta aptitud. Predeterminado: `false`.

Ubicaciones de habilidades

Las habilidades se cargan desde estas ubicaciones en orden de prioridad (la primera encontrada prevalece sobre nombres duplicados).

Ubicación	Ámbito	Description
`.github/skills/`	Proyecto	Aptitudes específicas del proyecto.
`.agents/skills/`	Proyecto	Ubicación alternativa del proyecto.
`.claude/skills/`	Proyecto	Ubicación compatible con Claude.
Padre `.github/skills/`	Inherited	Compatibilidad con directorios primarios de Monorepo.
`~/.copilot/skills/`	Personal	Habilidades personales para todos los proyectos.
`~/.claude/skills/`	Personal	Ubicación personal compatible con Claude.
Directorios de complementos	Plugin	Aptitudes de complementos instalados.
`COPILOT_SKILLS_DIRS`	Custom	Directorios adicionales (separados por comas).

Comandos (formato de habilidad alternativo)

Los comandos son una alternativa a las habilidades almacenadas como archivos individuales .md en .claude/commands/. El nombre del comando se deriva del nombre de archivo. Los archivos de comandos usan un formato simplificado (sin name campo necesario) y admiten description, allowed-toolsy disable-model-invocation. Los comandos tienen menor prioridad que las aptitudes con el mismo nombre.

Referencia de agentes personalizados

Los agentes personalizados son agentes de IA especializados definidos en archivos Markdown. El nombre de archivo (sin la extensión) se convierte en el identificador del agente. Use .agent.md o .md como extensión de archivo.

Agentes integrados

Agente	Modelo predeterminado	Description
`explore`	claude-haiku-4.5	Exploración rápida del código base. Busca archivos, lee código y responde preguntas. Devuelve respuestas centradas en menos de 300 palabras. Seguro para ejecutarse en paralelo.
`task`	claude-haiku-4.5	Ejecución de comandos (pruebas, compilaciones, lints). Devuelve un breve resumen en caso de éxito y la salida completa en caso de fallo.
`code-review`	claude-sonnet-4.5	Revisión de código con alta relación señal a ruido. Analiza diferencias en el código para detectar fallos, problemas de seguridad y errores lógicos.
`general-purpose`	claude-sonnet-4.5	Agente de funcionalidad completa para tareas complejas de varios pasos. Se ejecuta en una ventana de contexto independiente.

Campos de frontmatter del agente personalizado

Campo	Tipo	Obligatorio	Description
`name`	cuerda / cadena	No	Nombre para mostrar. El valor predeterminado es el nombre de archivo.
`description`	cuerda / cadena	Sí	Descripción que se muestra en la lista del agente y en la herramienta `task`.
`model`	cuerda / cadena	No	Modelo de IA para este agente. Cuando no se establece, hereda el modelo del agente externo.
`tools`	string[]	No	Herramientas disponibles para el agente. Valor predeterminado: `["*"]` (todas las herramientas).
`mcp-servers`	objeto	No	Servidores MCP para conectarse. Usa el mismo esquema que `~/.copilot/mcp-config.json`.
`infer`	boolean	No	Permitir la delegación automática del agente principal. Predeterminado: `true`.

Ubicaciones de agente personalizadas

Ámbito	Ubicación
Proyecto

          `.github/agents/` o `.claude/agents/` |

Los agentes de nivel de proyecto tienen prioridad sobre los agentes de nivel de usuario. Los agentes de complementos tienen la prioridad más baja.

Respuestas de aprobación de permisos

Cuando la CLI solicita permiso para ejecutar una operación, puede responder con las siguientes claves.

Key	Efecto
`y`	Permitir esta solicitud específica una vez.
`n`	Deniegue esta solicitud específica una vez.
`!`	Permitir todas las solicitudes similares para el resto de la sesión.
`#`	Deniegue todas las solicitudes similares para el resto de la sesión.
`?`	Mostrar información detallada sobre la solicitud.

Las aprobaciones de sesión se restablecen al ejecutar /clear o iniciar una nueva sesión.

Flag	Nivel	Description
`AUTOPILOT_MODE`	`experimental`	Modo de operación autónoma.
`BACKGROUND_AGENTS`	`staff`	Ejecute agentes en segundo plano.
`QUEUED_COMMANDS`	`staff`	Cola de comandos mientras el agente está en ejecución.
`LSP_TOOLS`	`on`	Herramientas del protocolo del servidor de lenguaje (LSP).
`PLAN_COMMAND`	`on`	Modo de planeamiento interactivo.
`AGENTIC_MEMORY`	`on`	Memoria persistente entre sesiones.
`CUSTOM_AGENTS`	`on`	Definiciones de agente personalizadas.