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:
gh copilot explain
gh copilot explain
Como alternativa, puede agregar el comando que quiera explicar directamente al símbolo del sistema:
gh copilot explain "sudo apt-get"
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:
gh copilot suggest
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:
gh copilot suggest "Install git"
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:
echo 'eval "$(gh copilot alias -- bash)"' >> ~/.bashrc
echo 'eval "$(gh copilot alias -- bash)"' >> ~/.bashrc
PowerShell
Ejecuta lo siguiente para agregar los alias al perfil de PowerShell:
$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
$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:
echo 'eval "$(gh copilot alias -- zsh)"' >> ~/.zshrc
echo 'eval "$(gh copilot alias -- zsh)"' >> ~/.zshrc
Una vez configurado el alias, puede ejecutar lo siguiente:
ghcs 'print "Hello world!"'
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.