Uso de la CLI de GitHub Copilot

La interfaz de la línea de comandos (CLI) para GitHub Copilot te permite usar Copilot directamente desde el terminal. Para más información, consulta Acerca de la CLI de GitHub Copilot.

Prerrequisito

Instalar CLI de Copilot. Consulta Instalación de la CLI de GitHub Copilot.

Usar CLI de Copilot

En el terminal, accede a una carpeta que contenga el código con el que deseas trabajar.
Escribe copilot para iniciar CLI de Copilot.

Copilot te pedirá que confirmes que confías en los archivos de esta carpeta.

Importante

Durante esta sesión de CLI de GitHub Copilot, Copilot puede intentar leer, modificar y ejecutar archivos dentro y debajo de esta carpeta. Solo debes continuar si confías en los archivos de esta ubicación. Para obtener más información acerca de los directorios de confianza, consulta Acerca de la CLI de GitHub Copilot.
Elija una de las siguientes opciones:
```
       **1. Sí, continuar**:
```
Copilot solo puede trabajar con los archivos de esta ubicación para esta sesión.
```
       **2. Sí y recordar esta carpeta para futuras sesiones**:
```
Confías en los archivos de esta carpeta para esta y futuras sesiones. No se te volverá a preguntar cuando inicies CLI de Copilot desde esta carpeta. Elige esta opción solo si estás seguro de que siempre será seguro que Copilot trabaje con archivos en esta ubicación.
```
       **3. No, salir (Esc)**:
```
Finaliza tu sesión de CLI de Copilot.
Si no has iniciado sesión actualmente en GitHub, se te pedirá que uses el comando de barra diagonal /login. Escribe este comando y sigue las instrucciones en pantalla para autenticarte.
Escribe un mensaje en la CLI.

Esto puede ser una pregunta de chat simple o una solicitud de Copilot para realizar una tarea específica, como corregir un error, agregar una característica a una aplicación existente o crear una nueva aplicación.

Para ver algunos ejemplos de mensajes, consulta Acerca de la CLI de GitHub Copilot.
Cuando Copilot desea usar una herramienta que pueda modificar o ejecutar archivos (Por ejemplo, touch, chmod, node, o sed), te pedirá que apruebes el uso de la herramienta.

Elija una de las siguientes opciones:
```
       **1. Sí**:
```
Permitir que Copilot use esta herramienta. La próxima vez que Copilot quiera usar esta herramienta, se te pedirá que la apruebes de nuevo.
```
       **2. Sí, y aprobar HERRAMIENTA para el resto de la sesión en ejecución**:
```
Permite que Copilot use esta herramienta, con cualquier opción, sin preguntar de nuevo el resto de la sesión que se está ejecutando actualmente. Las solicitudes de permisos en paralelo pendientes del mismo tipo se aprobarán automáticamente. Tendrás que volver a aprobar el comando en futuras sesiones.

Elegir esta opción es útil para muchas herramientas, como chmod, ya que evita que tenga que aprobar comandos similares repetidamente en la misma sesión. Sin embargo, tenga en cuenta las implicaciones de seguridad de esta opción. Por ejemplo, al elegir esta opción para el comando rm se permitiría que Copilot elimine cualquier archivo del directorio actual o sus subdirectorios sin pedir su aprobación.
```
       **3. No, e indicar a Copilot qué hacer de forma diferente (Esc)**:
```
Copilot no ejecutará el comando. En su lugar, finaliza la operación actual y espera el siguiente mensaje. Puedes indicar a Copilot que continúe la tarea, pero con un enfoque diferente.

Por ejemplo, si pides a Copilot que cree un script de Bash, pero no deseas usar el script que Copilot sugiere, puedes detener la operación actual y escribir un nuevo mensaje, como: Continue the previous task but include usage instructions in the script.

Al rechazar una solicitud de permiso de herramienta, también puede proporcionar a Copilot comentarios directos sobre el rechazo para que pueda adaptar su enfoque sin detenerse por completo.

Sugerencias

Optimiza tu experiencia con CLI de Copilot con las siguientes sugerencias.

Detener una operación que se está ejecutando actualmente

Si escribes un mensaje y, a continuación, decides que deseas impedir que Copilot complete la tarea mientras sigue "Pensando", presiona Esc.

Utilizar el modo de planificación

El modo plan le permite colaborar con Copilot en un plan de implementación antes de escribir cualquier código. Pulse Mayús+Tab para entrar y salir del modo del plan.

Dirigir la conversación mientras Copilot está pensando

Puede interactuar con Copilot mientras piensa. Envíe mensajes de seguimiento para dirigir la conversación en una dirección diferente, o ponga en cola instrucciones adicionales para que Copilot las procese una vez finalizada su respuesta actual.

Incluir un archivo específico en la indicación

Para agregar un archivo específico a la indicación, usa @ seguido de la ruta de acceso relativa al archivo. Por ejemplo: Explain @config/ci/ci-required-checks.yml o Fix the bug in @src/app.js. Esto agrega el contenido del archivo a la indicación como contexto para Copilot.

Al empezar a escribir una ruta de acceso de archivo, las rutas de acceso coincidentes se muestran debajo del cuadro de indicación. Usa las teclas de dirección para seleccionar una ruta de acceso y presiona la tecla Tab para completar la ruta de acceso en la indicación.

Trabajar con archivos en una ubicación diferente

Para completar una tarea, es posible que Copilot necesite trabajar con archivos que están fuera del directorio de trabajo actual. Si un mensaje que has especificado en una sesión interactiva requiere que Copilot modifique un archivo fuera de la ubicación actual, se te pedirá que apruebes el acceso al directorio del archivo.

También puedes agregar manualmente un directorio de confianza en cualquier momento mediante el comando de barra diagonal:

/add-dir /path/to/directory

Si todos los archivos con los que desea trabajar están en una ubicación diferente, puede cambiar el directorio de trabajo actual sin iniciar una nueva sesión CLI de Copilot mediante los comandos de barra /cwd o /cd.

/cwd /path/to/directory

Ejecución de comandos de shell

Puede anteponer la entrada con ! para ejecutar directamente comandos de shell, sin realizar una llamada al modelo.

!git clone https://github.com/github/copilot-cli

Obtención de Copilot para trabajar de forma autónoma

Puede indicar a Copilot que use su mejor criterio para completar una tarea de forma autónoma, en lugar de la CLI que le solicite la entrada en cada punto de decisión dentro de una tarea. Para ello, use el modo autopilot de la CLI.

Hay dos maneras de usar el modo Autopilot:

        **De forma interactiva:** En una sesión interactiva, presione <kbd>Mayús</kbd>+<kbd>Tab</kbd> hasta que vea "Autopilot" en la barra de estado. Si se le pide que elija permisos para el modo Autopilot, permita permisos completos y escriba el mensaje.

        **Mediante programación:** pase una solicitud a la CLI directamente en un comando e incluya la opción `--autopilot`. Por ejemplo, para usar el modo Autopilot con permisos completos, restringiéndolo a 10 continuaciones, escriba `copilot --autopilot --yolo --max-autopilot-continues 10 -p "YOUR PROMPT HERE"`.

Para más información, consulta Permitir que la CLI de GitHub Copilot funcione de forma autónoma.

Delegar tareas en Agente de codificación de Copilot

El comando delegate le permite enviar su sesión actual a Agente de codificación de Copilot en GitHub. Esto le permite entregar el trabajo mientras conserva todo el contexto que Copilot necesita para completar su tarea.

Puede delegar una tarea usando el comando de barra, seguido de una instrucción:

/delegate complete the API integration tests and fix any failing edge cases

Como alternativa, prefije un indicador con & para delegar el comando.

& complete the API integration tests and fix any failing edge cases

Copilot pedirá que confirme cualquiera de los cambios sin etiquetar como punto de control en una nueva rama que crea. Agente de codificación de Copilot abrirá un borrador de solicitud de incorporación de cambios, realizará cambios en segundo plano y solicitará su revisión.

Copilot proporcionará un enlace a la solicitud de incorporación de cambios y a la sesión del agente en GitHub una vez que comience la sesión.

Reanudar una sesión interactiva

Puede usar la opción de línea de comandos --resume o el comando de barra diagonal /resume para seleccionar y reanudar una sesión interactiva de la CLI, lo que le permite continuar justo donde lo dejó, con el contexto guardado. Puede iniciar una sesión de Agente de codificación de Copilot en GitHuby, a continuación, usar CLI de GitHub Copilot para llevar esa sesión al entorno local.

Sugerencia

Para reanudar rápidamente la sesión local cerrada más recientemente, escriba esto en el terminal:

copilot --continue

Usar instrucciones personalizadas

Puedes mejorar el rendimiento de Copilot agregando instrucciones personalizadas al repositorio en el que estás trabajando. Las instrucciones personalizadas son descripciones de lenguaje natural guardadas en archivos Markdown en el repositorio. Se incluyen automáticamente en los mensajes que escribas mientras trabajas en ese repositorio. Esto ayuda a que Copilot comprenda mejor el contexto del proyecto y cómo responder a tus indicaciones.

CLI de Copilot es compatible con:

Instrucciones para todo el repositorio en el archivo .github/copilot-instructions.md.
Archivos de instrucciones específicas de la ruta de acceso: .github/instructions/**/*.instructions.md.
Archivos de agente como AGENTS.md.

Para más información, consulta Adición de instrucciones personalizadas para CLI de GitHub Copilot.

Uso de agentes personalizados

Un agente personalizado es una versión especializada de Copilot. Agentes personalizados ayudan a Copilot a gestionar flujos de trabajo únicos, convenciones de codificación concretas y casos de uso especializados.

CLI de Copilot incluye un grupo predeterminado de agentes personalizados para tareas comunes:

Agente	Description
Explorar	Realiza un análisis rápido de código base, lo que le permite formular preguntas sobre el código sin agregar al contexto principal.
Tarea	Ejecuta comandos como pruebas y compilaciones, lo que proporciona resúmenes breves sobre éxito y salida completa en caso de error.
Uso general	Controla tareas complejas y de varios pasos que requieren el conjunto de herramientas completo y el razonamiento de alta calidad, que se ejecutan en un contexto independiente para mantener la conversación principal claramente centrada.
Revisión de código	Revisa los cambios con un enfoque en identificar solo problemas genuinos, minimizando el ruido.

El modelo de inteligencia artificial que utiliza la CLI puede elegir delegar una tarea en un proceso de subagente subsidiario, que opera usando un agente personalizado con conocimientos específicos, si considera que esto haría que el trabajo se realice de manera más eficaz. El modelo puede igualmente optar por gestionar el trabajo directamente en el agente principal.

Puede definir sus propios agentes personalizados con archivos Markdown, denominados perfiles de agente, que especifican qué experiencia debe tener el agente, qué herramientas puede usar y las instrucciones específicas sobre cómo debe responder.

Puede definir agentes personalizados en el nivel de usuario, organización/empresa o repositorio:

Tipo	Ubicación	Ámbito
Nivel de usuario agente personalizado	directorio local `~/.copilot/agents`	Todos los proyectos
Nivel de repositorio agente personalizado

          `.github/agents` directorio en los repositorios locales y remotos | Proyecto actual |

| Nivel de organización y empresa agente personalizado | Directorio /agents en el repositorio .github-private de una organización o empresa | Todos los proyectos de su organización y cuenta empresarial |

En el caso de conflictos de nomenclatura, un agente de nivel de sistema invalida un agente de nivel de repositorio y el agente de nivel de repositorio invalidaría un agente de nivel de organización.

Agentes personalizados se pueden usar de tres maneras:

Usando el comando de barra en la interfaz interactiva de la CLI para seleccionar de la lista de agentes personalizados disponibles:
```
/agent
```
Llamando a agente personalizado directamente en un mensaje:
```
Use the refactoring agent to refactor this code block
```
Copilot deducirá automáticamente el agente que quieres usar.
Especificando el agente personalizado que desea utilizar con la opción de línea de comandos. Por ejemplo:
```
copilot --agent=refactor-agent --prompt "Refactor this code block"
```

Para más información, consulta Creación de agentes personalizados para Agente de codificación de Copilot.

Uso de aptitudes

Puede crear aptitudes para mejorar la capacidad de Copilot para realizar tareas especializadas con instrucciones, scripts y recursos.

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

Agregar un servidor MCP

CLI de Copilot viene con el servidor MCP de GitHub ya configurado. Este servidor MCP te permite interactuar con recursos en GitHub.com, por ejemplo, lo que te permite combinar solicitudes de incorporación de cambios de la CLI.

Para ampliar la funcionalidad disponible en CLI de Copilot, puedes agregar más servidores MCP:

Usa el siguiente comando de barra diagonal:
```
/mcp add
```
Rellena los detalles del servidor MCP que deseas agregar, con la tecla Tab para moverte entre los campos.
Pulse Ctrl+S para guardar los detalles.

Los detalles de los servidores MCP configurados se almacenan en el archivo mcp-config.json, que se encuentra, de forma predeterminada, en el directorio ~/.copilot. Esta ubicación se puede cambiar estableciendo la variable de entorno XDG_CONFIG_HOME. Para obtener información sobre la estructura JSON de una definición de servidor, consulta Extensión del agente de codificación de GitHub Copilot con el protocolo de contexto de modelo (MCP).

Para obtener información más detallada sobre cómo agregar y administrar servidores MCP en CLI de Copilot, vea Añadir servidores MCP para CLI de GitHub Copilot.

Administración de contexto

CLI de Copilot proporciona varios comandos de barra para ayudarle a supervisar y administrar su ventana de contexto.

```
        `/usage`: le permite ver las estadísticas de sesión, entre las que se incluyen:
```
- Cantidad de solicitudes premium usadas en la sesión actual
- Duración de la sesión
- Líneas totales de código editadas
- Desglose del uso de tokens por modelo

        `/context`: proporciona información general visual sobre el uso del token actual.

        `/compact`: comprime manualmente el historial de conversaciones para liberar espacio de contexto.

CLI de GitHub Copilot comprime automáticamente el historial en segundo plano cuando la conversación se aproxima a 95% del límite de tokens, sin interrumpir el flujo de trabajo.

Revisar los cambios de código

Puede usar el /review comando slash para permitir que Copilot analice los cambios de código sin salir de la CLI. Esto le permite recibir comentarios rápidos sobre los cambios antes de confirmar.

Habilitación de todos los permisos

En situaciones en las que confía en que Copilot se ejecute libremente, puede usar las marcas --allow-all o --yolo para habilitar todos los permisos a la vez.

Alternar la visibilidad del razonamiento

Presione Ctrl+T para mostrar u ocultar el proceso de razonamiento del modelo mientras genera una respuesta. Esta configuración persiste durante múltiples sesiones, lo que le permite observar cómo Copilot aborda problemas complejos.

Obtén más información

Para obtener una lista completa de las opciones de línea de comandos y los comandos de barra diagonal que puedes usar con CLI de Copilot, sigue uno de estos procedimientos:

Escribe ? en el cuadro de indicación de una sesión interactiva.
Escribe copilot help en el terminal.

Para obtener información adicional, usa uno de los siguientes comandos en el terminal:

```
        **Opciones de configuración**:
```
copilot help config

Puedes ajustar las opciones de configuración editando el archivo config.json, que se encuentra, de forma predeterminada, en el directorio ~/.copilot. Esta ubicación se puede cambiar estableciendo la variable de entorno XDG_CONFIG_HOME.

        **Variables de entorno** que afectan a CLI de Copilot:

copilot help environment

        **Niveles de registro disponibles**:

copilot help logging

        **Permisos** para permitir o denegar el uso de la herramienta:

copilot help permissions

Comentarios

Si tienes algún comentario sobre los datos de CLI de GitHub Copilot, háznoslo saber mediante el comando de barra diagonal /feedback en una sesión interactiva y eligiendo una de las opciones. Puedes completar una encuesta privada de comentarios, enviar un informe de errores o sugerir una nueva característica.

Lectura adicional

        [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)

        [AUTOTITLE](/copilot/reference/cli-command-reference)

        [AUTOTITLE](/copilot/reference/acp-server)

¿Quién puede utilizar esta característica?

En este artículo