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 AUTOTITLE.

Prerrequisito

Instalar CLI de Copilot. Consulta AUTOTITLE.

Usar CLI de Copilot

1. En el terminal, accede a una carpeta que contenga el código con el que deseas trabajar.

2. Escribe 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 AUTOTITLE.

3. 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.

4. Si no has iniciado sesión actualmente en GitHub, se te pedirá que uses el comando de barra diagonal . Escribe este comando y sigue las instrucciones en pantalla para autenticarte.

5. 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 AUTOTITLE.

6. 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 , 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 se permitiría que Copilot elimine cualquier archivo del directorio actual o sus subdirectorios sin pedir su aprobación.

          **3. No, e indique 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: .

   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 y Tab para entrar y salir del modo del plan.

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: o . 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 o .

/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

Reanudar una sesión interactiva

Puede usar la opción de línea de comandos o el comando de barra diagonal 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.

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 .
• Archivos de instrucciones específicas de la ruta de acceso: .
• Archivos de agente como .

Para más información, consulta AUTOTITLE.

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:

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:

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 AUTOTITLE.

Usar capacidades

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

Para más información, consulta AUTOTITLE.

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:

1. Usa el siguiente comando de barra diagonal:

   /mcp add
   

2. Rellena los detalles del servidor MCP que deseas agregar, con la tecla Tab para moverte entre los campos.

3. Pulse CtrlS para guardar los detalles.

Los detalles de los servidores MCP configurados se almacenan en el archivo , que se encuentra, de forma predeterminada, en el directorio . Esta ubicación se puede cambiar estableciendo la variable de entorno . Para obtener información sobre la estructura JSON de una definición de servidor, consulta AUTOTITLE.

Administración de contexto

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

• : 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

• : proporciona información general visual sobre el uso del token actual.

• : 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.

Habilitación de todos los permisos

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

Alternar la visibilidad del razonamiento

Presione CtrlT 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 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 , que se encuentra, de forma predeterminada, en el directorio . Esta ubicación se puede cambiar estableciendo la variable de entorno .

• 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.

Pasos siguientes

CLI de Copilot pueden funcionar como asistente conversacional, responder preguntas y ayudarle a escribir código de forma interactiva. Más allá del chat, CLI de Copilot admite una gama de modos de agente que permiten delegar tareas con mayor autonomía.

Puede trabajar con agentes en CLI de Copilot para gestionar un ciclo de vida completo de tareas, desde delegar el trabajo hasta revisar los resultados.

• Delegar tareas de forma autónoma: ejecute CLI de Copilot en modo Autopilot para completar tareas de varios pasos sin necesidad de aprobación en cada paso. Consulta AUTOTITLE.
• Invocar agentes personalizados: invoque agentes especializados adaptados a tareas específicas, como revisión de código, documentación o auditorías de seguridad. Consulta AUTOTITLE.
• Agentes orientadores: oriente y optimice el comportamiento del agente durante la ejecución de la tarea para mantener el trabajo en curso. Consulte AUTOTITLE.
• Solicitar una revisión de código: utilice CLI de Copilot para obtener una revisión impulsada por inteligencia artificial de las modificaciones en su código. Consulta AUTOTITLE.

Lectura adicional

• AUTOTITLE
• AUTOTITLE
• AUTOTITLE