Uso de la CLI de GitHub Copilot

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

Prerrequisito

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

Uso de CLI de Copilot

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

2. Escriba copilot para iniciar CLI de Copilot.

          Copilot le pedirá que confirme que confía en los archivos de esta carpeta.
   

   Importante

   Durante esta CLI de GitHub Copilot sesión, Copilot puede intentar leer, modificar y ejecutar archivos en 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 GitHub Copilot CLI.

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 le preguntará de nuevo cuando empiece CLI de Copilot desde esta carpeta. Elija solo esta opción si está seguro de que siempre será seguro para Copilot trabajar con archivos en esta ubicación.

          **3. No, salir (Esc)**:
   

   Finalice la CLI de Copilot sesión.

4. Si no ha iniciado sesión actualmente en GitHub, se le pedirá que use el /login comando de barra diagonal. Escribe este comando y sigue las instrucciones en pantalla para autenticarte.

5. Escribe un mensaje en la CLI.

   Puede ser una pregunta de chat simple o una solicitud para Copilot 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 GitHub Copilot CLI.

6. Cuando Copilot quiera usar una herramienta que pueda modificar o ejecutar archivos,Por ejemplo, touch, chmod, node, o sed le pedirá que apruebe el uso de la herramienta.

   Elija una de las siguientes opciones:

          **1. Sí**:
   

   Permitir Copilot usar esta herramienta. La próxima vez Copilot que quiera usar esta herramienta, le pedirá que la apruebe de nuevo.

          **2. Sí, y aprobar HERRAMIENTA para el resto de la sesión en ejecución**:
   

   Permitir que Copilot use esta herramienta con cualquier opción, sin volver a preguntar, durante el resto de la sesión en curso. 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, elegir esta opción para el comando rm permitiría Copilot eliminar 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. Puede indicarle Copilot que continúe la tarea, pero con un enfoque diferente.
   

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

   Al rechazar una solicitud de permiso de herramienta, también puede proporcionar Copilot comentarios en línea sobre el rechazo para que pueda adaptar su enfoque sin detenerse completamente.

Sugerencias

Optimice su experiencia con CLI de Copilot con las siguientes sugerencias.

Detener una operación que se está ejecutando actualmente

Si escribe un mensaje y, a continuación, decide que desea detener Copilot de completar la tarea mientras todavía está "Pensando", presione Esc.

Utilizar el modo de planificación

El modo de planificación 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.

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 añade el contenido del archivo a tu solicitud 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, Copilot puede que tenga que trabajar con archivos que están fuera del directorio de trabajo actual. Si un mensaje que ha escrito en una sesión interactiva requiere Copilot modificar un archivo fuera de la ubicación actual, se le pedirá que apruebe 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 CLI de Copilot sesión utilizando los comandos slash /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

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 Agente de programación Copilot sesión en GitHuby, a continuación, usar CLI de GitHub Copilot para llevar esa sesión al entorno local.

copilot --continue

Usar instrucciones personalizadas

Puede 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 Copilot a comprender mejor el contexto de tu proyecto y a responder a tus indicaciones.

          CLI de Copilot admite lo siguiente:

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

Utilice agentes personalizados

A agente personalizado es una versión especializada de Copilot. Agentes personalizados ayudar a Copilot controlar 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 usa la CLI puede elegir delegar una tarea a un proceso de subagente, que opera utilizando una agente personalizado con experiencia específica, si considera que esto resultaría en un trabajo completado de manera más eficaz. El modelo puede igualmente optar por gestionar el trabajo directamente en el agente principal.

Puede definir su propio agentes personalizados usando archivos Markdown, llamados 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, repositorio o organización o empresa:

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

| Organización y nivel empresarial 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 puede usar de tres maneras:

• Usando el comando slash en la interfaz interactiva de la CLI para seleccionar de la lista de opciones disponibles agentes personalizados.

  /agent
  

• Llamando directamente a agente personalizado en una indicación:

  Use the refactoring agent to refactor this code block
  

          Copilot deducirá automáticamente el agente que desea usar.
  

• Especifique el agente personalizado que desea usar mediante 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 programación Copilot.

Usar capacidades

Puede crear aptitudes para mejorar la capacidad de Copilot 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 GitHub servidor MCP ya configurado. Este servidor MCP permite interactuar con los recursos en GitHub.com, por ejemplo, permite fusionar pull requests desde la CLI.

Para ampliar la funcionalidad disponible en CLI de Copilot, puede 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 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 COPILOT_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).

Administración de contexto

          CLI de Copilot proporciona varios comandos de barra diagonal para ayudarle a supervisar y administrar la 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.
  

Habilitación de todos los permisos

En situaciones en las que confía en que Copilot se ejecute libremente, puede usar las banderas --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 en las sesiones, lo que le permite observar cómo Copilot funciona a través de 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 puede usar con CLI de Copilot, realice una de las acciones siguientes:

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

Pasos siguientes

          CLI de Copilot puede 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 agente que permiten delegar tareas con mayor autonomía.

Puede trabajar con agentes en CLI de Copilot para apoyar 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](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca).
  

•         **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](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents).
  

•         **Dirigir a los agentes**: puede guiar y ajustar el comportamiento del agente durante la ejecución de la tarea para mantener el trabajo en curso. Consulte [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents).
  

•         **Solicitar una revisión de código**: use CLI de Copilot para obtener una revisión con tecnología de inteligencia artificial de los cambios en el código. Consulta [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review).
  

Lectura adicional

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

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

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)
  

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