Referencia de comandos de la CLI de GitHub Copilot

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: , , , y .
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. Acepta especificar la dirección URL de host GitHub (valor predeterminado: ).
copilot logout	Cierre la sesión de GitHub y quite las credenciales almacenadas.
copilot plugin	Administrar complementos y mercados de complementos.

Accesos directos globales en la interfaz interactiva

Shortcut	Propósito
@ FILENAME	Incluya el contenido del archivo en el contexto.
CtrlX 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.
Esc	Cancele la operación actual.
! COMMAND	Ejecute un comando en el shell local, omitiendo Copilot.
CtrlC	Cancelar operación/borrar entrada. Presione dos veces para salir.
CtrlD	Apagado.
CtrlL	Borre la pantalla.
MayúsTabulador	Ciclo entre el modo estándar, plan y autopilot.

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.

Accesos directos de navegación en la interfaz interactiva

Shortcut	Propósito
CtrlA	Ir al principio de la línea (al escribir).
CtrlB	Vaya al carácter anterior.
CtrlE	Vaya al final de la línea (al escribir).
CtrlF	Vaya al siguiente carácter.
CtrlG	Edite el mensaje en un editor externo.
CtrlH	Elimine el carácter anterior.
CtrlK	Eliminar desde el cursor hasta el final de la línea.
CtrlU	Eliminar desde el cursor hasta el principio de la línea.
CtrlW	Elimine la palabra anterior.
Página principal	Vaya al inicio de la línea actual.
Fin	Vaya al final de la línea actual.
CtrlInicio	Vaya al principio del texto.
CtrlFin	Vaya al final del texto.
Meta←	Mueva el cursor una palabra a la vez.
^→	Navegue por el historial de comandos.

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).
,	Habilite todos los permisos (herramientas, rutas de acceso y direcciones URL).
,	Borre el historial de conversaciones.
/compact	Resumir el historial de conversaciones para reducir el uso de la ventana de contexto.
/context	Muestra el uso y la visualización del token de la ventana de contexto.
,	Cambie el directorio de trabajo o muestre el directorio actual.
/delegate [PROMPT]	Delegar cambios en un repositorio remoto con una solicitud de incorporación de cambios generada por IA.
/diff	Revise los cambios realizados en el directorio actual.
,	Salir de la CLI.
/experimental [on|off]	Active o desactive las características experimentales.
/feedback	Proporcione comentarios sobre la CLI.
/fleet [PROMPT]	Habilite la ejecución paralela de subagentes de partes de una tarea. Consulta AUTOTITLE.
/help	Mostrar la ayuda para comandos interactivos.
/ide	Conéctese a un área de trabajo del IDE.
/init	Inicializar instrucciones personalizadas de Copilot y capacidades de agente para este repositorio.
/list-dirs	Muestra todos los directorios para los que se ha permitido el acceso a archivos.
/login	Inicie sesión en Copilot.
/logout	Salir de Copilot.
/lsp [show|test|reload|help] [SERVER-NAME]	Administrar la configuración del servidor de idioma.
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME]	Administrar la configuración del servidor MCP.
,	Seleccione el modelo de IA que desea usar.
/plan [PROMPT]	Cree un plan de implementación antes de codificar.
/plugin [marketplace|install|uninstall|update|list] [ARGS...]	Administrar complementos y mercados de complementos.
/rename NAME	Cambie el nombre de la sesión actual (alias para ).
/reset-allowed-tools	Restablezca la lista de herramientas permitidas.
/resume [SESSION-ID]	Cambie a otra sesión eligiendo entre una lista (opcionalmente, especifique un identificador de sesión).
/review [PROMPT]	Ejecute el agente de revisión de código para analizar los cambios.
/session [checkpoints [n]|files|plan|rename NAME]	Mostrar información de sesión y un resumen del área de trabajo. Use los subcomandos para obtener más información.
/share [file|gist] [PATH]	Comparta la sesión en un archivo Markdown o GitHub gist.
/skills [list|info|add|remove|reload] [ARGS...]	Gestionar habilidades para capacidades mejoradas.
/terminal-setup	Configure el terminal para la compatibilidad con la entrada multilínea (MayúsEntrar y CtrlEntrar).
/theme [show|set|list] [auto|THEME-ID]	Vea o configure el tema de terminal.
/usage	Muestra las estadísticas y métricas de uso de la sesión.
/user [show|list|switch]	Administre el usuario actual GitHub .

Para obtener una lista completa de los comandos de barra diagonal disponibles, escriba 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 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 . 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-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: ).
--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 ( o ).
--autopilot	Habilite la continuación del piloto automático en modo aviso. Consulta AUTOTITLE.
--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 con shells de Bash ( o ).
--config-dir PATH	Establezca el directorio de configuración (valor predeterminado: ).
--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 .
--disable-builtin-mcps	Deshabilite todos los servidores MCP integrados (actualmente: ).
--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 y .
--excluded-tools [TOOLS...]	Estas herramientas no estarán disponibles para el modelo.
--experimental	Habilite las características experimentales (use para deshabilitar).
,	Mostrar ayuda.
,	Inicie una sesión interactiva y ejecute automáticamente esta solicitud.
--log-dir DIRECTORY	Establezca el directorio del archivo de registro (valor predeterminado: ).
--log-level LEVEL	Configure el nivel de registro (opciones: , , , , , , ).
--max-autopilot-continues COUNT	Número máximo de mensajes de continuación en el modo autopilot (valor predeterminado: ilimitado). Consulta AUTOTITLE.
--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 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 con los shells de Bash.
--no-color	Deshabilite toda la salida de color.
--no-custom-instructions	Deshabilite la carga de instrucciones personalizadas desde y archivos relacionados.
--no-experimental	Desactivar las funciones experimentales.
,	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).
,	Genera solo la respuesta del agente (sin estadísticas de uso), útil para el scripting con .
--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: ).
--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: o ).
,	Mostrar información de versión.
--yolo	Habilite todos los permisos (equivalentes a ).

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

Patrones de permisos de herramientas

Las opciones y aceptan patrones de permisos con el formato . 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	, , ,
write	Creación o modificación de archivos	,
read	Lecturas de archivos o directorios	,
SERVER-NAME	Invocación de la herramienta de servidor MCP	,
url	Acceso a la URL a través de web-fetch o shell	,
memory	Almacenamiento de hechos en la memoria del agente	memory

Para las reglas de , el sufijo coincide con la raíz del comando seguido de un espacio, evitando coincidencias parciales. Por ejemplo, coincide con y , pero no coincide con .

Las reglas de denegación siempre tienen prioridad sobre las reglas de autorización, incluso cuando 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 para permitir todos los permisos automáticamente (equivalente a ).
COPILOT_AUTO_UPDATE	Establézcalo en 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 y ). El valor predeterminado es si no se establece ninguno.
COPILOT_GITHUB_TOKEN	Token de autenticación. Tiene prioridad sobre y .
GH_TOKEN	Token de autenticación. Tiene prioridad sobre .
GITHUB_TOKEN	Token de autenticación.
XDG_CONFIG_HOME	Invalide el directorio de configuración. Predeterminado: .
XDG_STATE_HOME	Invalide el directorio de estado. Predeterminado: .
USE_BUILTIN_RIPGREP	Establézcalo en para usar el ripgrep del sistema en lugar de la versión incluida.
PLAIN_DIFF	Establézcalo en 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, ).

Configuración del archivo de configuración

La configuración del usuario se almacena en . La configuración de nivel de proyecto se puede colocar en (almacenada en el repositorio) o (invalidaciones personales—agregue a ). 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.
bash_env	boolean	false	Habilitar la compatibilidad con las shells Bash.
beep	boolean	true	Reproduce un pitido audible cuando se requiere atención.
compact_paste	boolean	true	Colapsa grandes fragmentos en tokens compactos.
custom_agents.default_local_only	boolean	false	Use solo agentes personalizados locales.
denied_urls	string[]	[]	Direcciones URL o dominios bloqueados (tiene prioridad sobre ).
experimental	boolean	false	Habilite las características experimentales.
include_coauthor	boolean	true	Agregue un trailer a las confirmaciones de Git realizadas por el agente.
launch_messages	string[]	[]	Mensajes personalizados mostrados aleatoriamente durante el inicio.
log_level	"none" | "error" | "warning" | "info" | "debug" | "all" | "default"	"default"	Nivel de verbosidad del registro.
model	string	varies	Modelo de IA que se va a usar (consulte el comando ).
reasoning_effort	"low" | "medium" | "high" | "xhigh"	"medium"	Nivel de esfuerzo cognitivo para el pensamiento prolongado. Los niveles superiores usan más recursos de computación.
render_markdown	boolean	true	Representar Markdown en la salida del terminal.
screen_reader	boolean	false	Habilite las optimizaciones del lector de pantalla.
stream	boolean	true	Habilite las respuestas de streaming.
store_token_plaintext	boolean	false	Almacene tokens de autenticación en texto no cifrado en el archivo de configuración cuando no haya ninguna cadena de claves del sistema disponible.
streamer_mode	boolean	false	Ocultar los nombres de modelo de vista previa y los detalles de cuota (útiles al grabar).
theme	"auto" | "dark" | "light"	"auto"	Tema de color de terminal.
trusted_folders	string[]	[]	Carpetas con permisos de acceso a archivos concedidos previamente.
update_terminal_title	boolean	true	Mostrar la intención actual en el título del terminal.

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 de tu repositorio.

Formato de configuración de gancho

Los archivos de configuración de enlace usan el formato JSON con la versión :

{
  "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 .
bash	cuerda / cadena	Uno de	Comando shell para Unix.
powershell	cuerda / cadena	Uno de	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: .

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

control de decisión

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

Campo	Valores	Description
permissionDecision	, , ,	Si se ejecuta la herramienta. La salida vacía usa el comportamiento predeterminado.
permissionDecisionReason	cuerda / cadena	Motivo que se muestra al agente. Obligatorio cuando la decisión es .
modifiedArgs	objeto	Sustituya los argumentos de la herramienta para usar en lugar de los originales.

control de decisión

Campo	Valores	Description
decision	,	obliga a otro agente a realizar un turno usando como solicitud.
reason	cuerda / cadena	Solicite el siguiente turno cuando sea .

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 , si algún gancho devuelve , 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 . Use 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.	,
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 , y expansión.
cwd	No	Directorio de trabajo para el servidor.
timeout	No	Tiempo de espera en milisegundos para la llamada a herramienta.
type	No	o . Predeterminado: .

Campos de configuración de servidor remoto

Campo	Obligatorio	Description
type	Sí	o .
url	Sí	Dirección URL del servidor.
tools	Sí	Herramientas para habilitar.
headers	No	Encabezados HTTP. Admite la expansión de variables.
oauthClientId	No	Identificador de cliente de OAuth estático (omite el registro dinámico).
oauthPublicClient	No	Si el cliente de OAuth es público. Predeterminado: .
timeout	No	Tiempo de espera en milisegundos para la llamada a herramienta.

Asignación de filtros

Controlar cómo se procesa la salida de la herramienta MCP mediante el 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 .
time	Utilidades de tiempo: y .

Use para deshabilitar todos los servidores integrados o 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 archivo. Cuando se invoca (a través de 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 . Predeterminado: .
disable-model-invocation	boolean	No	Impedir que el agente invoque automáticamente esta aptitud. Predeterminado: .

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	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 en . El nombre del comando se deriva del nombre de archivo. Los archivos de comandos usan un formato simplificado (sin campo necesario) y admiten , y . 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 o como extensión de archivo.

Agentes integrados

Agente	Modelo predeterminado	Description
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.
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.
general-purpose	claude-sonnet-4.5	Agente de funcionalidad completa para tareas complejas de varios pasos. Se ejecuta en una ventana de contexto independiente.
research	claude-sonnet-4.6	Agente de investigación profundo. Genera un informe basado en la información de su código base, en repositorios pertinentes y en la web.
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.

Campos de frontmatter del agente personalizado

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

Ubicaciones de agente personalizadas

Ámbito	Ubicación
Proyecto	o
Usuario	o
Plugin	<plugin>/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 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.