Uso de GitHub Copilot en la CLI

También puede usar gh, la interfaz de línea de comandos GitHub con GitHub Copilot in the CLI.

En este artículo

Acerca del uso de GitHub Copilot in the CLI

GitHub CLI es una herramienta de código abierto para usar GitHub desde la línea de comandos del equipo. Cuando trabajas desde la línea de comandos, puedes utilizar el GitHub CLI para ahorrar tiempo y evitar cambiar de contexto. Para obtener más información, consulte "Acerca del CLI de GitHub".

GitHub Copilot in the CLI es una extensión de GitHub CLI que proporciona una interfaz similar al chat en el terminal que le permite formular preguntas sobre los comandos que ejecuta desde la línea de comandos. Puede pedir a Copilot in the CLI que sugiera un comando para su caso de uso, con gh copilot suggest, o para explicar un comando que le interese, con gh copilot explain.

Asimismo, puede usar gh copilot --help para obtener ayuda general o gh copilot SUBCOMMAND --help para obtener ayuda con un subcomando específico.

Requisitos previos

Para acceder a la GitHub Copilot in the CLI necesitará lo siguiente.

  • Una suscripción de GitHub Copilot: debe tener una suscripción de GitHub Copilot activa. Para obtener más información, vea «Acerca de la facturación de GitHub Copilot».
  • Acceso a Copilot in the CLI: si forma parte de una organización con una suscripción de GitHub Copilot Business, el propietario de la organización deberá concederle acceso a Copilot in the CLI. Para obtener más información, vea «Configuración de GitHub Copilot en la CLI».
  • Instalar GitHub CLI: debe tener GitHub CLI instalada. A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.
  • Instalar la extensión Copilot in the CLI: además, debe tener instalada la extensión Copilot in the CLI. Para obtener más información, consulte “Instalación de Copilot in the CLI”.

Peticiones a Copilot in the CLI para que explique un comando

Puede pedir a Copilot in the CLI que le explique un comando mediante la ejecución de:

Shell
gh copilot explain

Como alternativa, puede agregar el comando que quiera explicar directamente al símbolo del sistema:

Shell
gh copilot explain "sudo apt-get"

Copilot in the CLI le puede ayudar explicando lo que hace un comando en un lenguaje sencillo. Esto facilita la comprensión del propósito del comando y le permite saber cómo funcionará en un ejemplo específico. No es necesario revisar la documentación del comando, porque la explicación incluye información sobre lo que toma el comando como entrada y genera como salida, y proporciona ejemplos prácticos.

Peticiones a Copilot in the CLI para que sugiera un comando

Puede pedir a Copilot in the CLI que le sugiera un comando mediante la ejecución de:

Shell
gh copilot suggest

Esto iniciará una experiencia interactiva para obtener el comando que necesita. Copilot in the CLI pretende sugerir comandos que le ayuden a realizar las tareas que intenta completar. Para que Copilot in the CLI proporcione mejores sugerencias, puede especificar el tipo de comando que busca (genérico, git o gh).

Si ya sabe qué comando necesita, también puede incluirlo en el símbolo del sistema. Por ejemplo, si quiere instalar Git, puede pedirle a Copilot in the CLI que le sugiera un comando:

Shell
gh copilot suggest "Install git"

Si el resultado no es lo que busca, puede reescribir la consulta hasta que el comando devuelto cumpla sus expectativas. Para ello, seleccione la opción Revisar comando.

Una vez que haya generado el comando perfecto para la tarea, puede copiarlo fácilmente en el Portapapeles y ejecutarlo siempre que lo necesite seleccionando la opción Copiar en el Portapapeles o ejecutando el comando.

Ejecutar el comando

Después de que Copilot in the CLI sugiere un comando, puede elegir ejecutar el comando seleccionando la opción Ejecutar comando. Si selecciona esta opción después de ejecutar gh copilot suggest para solicitar una sugerencia, Copilot in the CLI copiará el comando en el Portapapeles y se cerrará de la sesión interactiva automáticamente. Después, puede pegar el comando y ejecutarlo usted mismo.

Si desea que Copilot in the CLI ejecute comandos automáticamente, el alias ghcs generado por gh copilot alias proporciona esta compatibilidad. Para obtener más información sobre cómo configurar el alias ghcs, consulte "Configuración de alias para Copilot in the CLI".

Cuando use el alias ghcs y seleccione Ejecutar comando, Copilot in the CLI solicitará la confirmación antes de ejecutar el comando. El mensaje de confirmación tiene No como valor predeterminado, pero puede cambiar su preferencia a través de la opción gh copilot config. Para obtener más información, vea «Configuración de GitHub Copilot en la CLI».

Si confirma, el comando se ejecutará y guardará en el historial del shell para obtener una referencia futura.

Configuración de alias para Copilot in the CLI

Con gh copilot alias, puede crear alias para Copilot in the CLI. Los alias no son necesarios para usar Copilot in the CLI, pero pueden ser útiles para mayor comodidad, ya que requieren menos pulsaciones de tecla y ayudan a ejecutar comandos sugeridos.

También puede usar los alias proporcionados para encapsular gh copilot suggest y gh copilot explain. Los alias proporcionados son ghcs y ghce. Para usar ghcs y ghce, deberá agregar algunas configuraciones de alias al archivo de configuración del shell.

En los ejemplos siguientes se muestra cómo agregar las configuraciones de alias a los archivos de configuración de Bash, PowerShell y Zsh.

Bash

Ejecuta lo siguiente para agregar los alias al archivo de configuración Bash:

Shell
echo 'eval "$(gh copilot alias -- bash)"' >> ~/.bashrc

PowerShell

Ejecuta lo siguiente para agregar los alias al perfil de PowerShell:

Shell
$GH_COPILOT_PROFILE = Join-Path -Path $(Split-Path -Path $PROFILE -Parent) -ChildPath "gh-copilot.ps1"
gh copilot alias -- pwsh | Out-File ( New-Item -Path $GH_COPILOT_PROFILE -Force )
echo ". `"$GH_COPILOT_PROFILE`"" >> $PROFILE

Zsh

Ejecuta lo siguiente para agregar los alias al archivo de configuración Zsh:

Shell
echo 'eval "$(gh copilot alias -- zsh)"' >> ~/.zshrc

Una vez configurado el alias, puede ejecutar lo siguiente:

Shell
ghcs 'print "Hello world!"'

Uso compartido de comentarios sobre Copilot in the CLI

Si encuentra algún problema o limitaciones con Copilot in the CLI, puede proporcionar comentarios seleccionando la opción Puntuar respuesta en Copilot in the CLI.