Controlar una CLI de GitHub Copilot sesión desde otro dispositivo

Habilite el control remoto para una CLI de Copilot sesión para que pueda supervisar el progreso, responder a las indicaciones y continuar trabajando desde GitHub.com o GitHub Mobile.

En este artículo

El control remoto le permite conectarse a una sesión en ejecución CLI de Copilot desde cualquier explorador o desde GitHub Mobile. Puede ver la salida de la sesión, responder a las solicitudes de permisos y continuar trabajando en la sesión sin estar en la máquina donde se ejecuta la sesión.

En este artículo se explica cómo habilitar y usar el control remoto. Para obtener más información conceptual, consulte Acerca del control remoto de sesiones CLI de GitHub Copilot.

Prerequisites

  • La máquina donde se ejecuta la sesión de la CLI debe estar en línea, con la sesión que se ejecuta activamente en un terminal.

    Sugerencia

    Use el comando de la barra diagonal /keep-alive para evitar que su equipo entre en suspensión mientras está ausente. Consulte Impedir que la máquina vaya a dormir.

  • El directorio de trabajo debe contener un repositorio de Git hospedado en GitHub.com. Si no está en un GitHub repositorio, la CLI muestra: "Sesión remota deshabilitada: no en un GitHub repositorio".

Habilitación del control remoto para una sesión

Puede habilitar el control remoto de tres maneras:

  • Con un comando de barra diagonal durante una sesión interactiva.
  • Con una opción de línea de comandos al iniciar CLI de Copilot.
  • Mediante la configuración de la CLI para habilitar el control remoto de forma predeterminada para todas las sesiones interactivas.

Usar el comando de barra diagonal /remote

Si ya está en una sesión interactiva y desea habilitar el control remoto, escriba:

Copilot prompt
/remote on

La CLI se conecta a GitHub.com y muestra detalles para acceder a la sesión de forma remota; consulte más adelante en este artículo Acceso a una sesión desde GitHub.com y Acceso a una sesión desde GitHub Mobile.

Puede usar el /remote comando de barra diagonal sin un argumento para comprobar el estado actual del control remoto o para volver a reproducir los detalles del acceso remoto si el control remoto está habilitado actualmente. Si desea finalizar la conexión remota para la sesión actual, escriba /remote off.

Uso de la opción de línea de comandos --remote

Si cree que desea acceder a una sesión de forma remota, puede iniciar la CLI con la --remote opción de línea de comandos. Esto evita la necesidad de recordar el uso del /remote comando de barra diagonal durante la sesión.

Bash
copilot --remote

Los detalles para acceder a la sesión de forma remota se muestran cuando se inicia la sesión interactiva y se pueden volver a mostrar en cualquier momento mediante el /remote comando de barra diagonal.

Configuración del control remoto para que siempre esté habilitado

Si siempre quiere que las sesiones interactivas de la CLI sean accesibles de forma remota, agregue lo siguiente al Copilot archivo de configuración (normalmente ubicado en ~/.copilot/settings.json):

JSON
{
  "remoteSessions": true
}

Para invalidar esta configuración para una sesión determinada, use la --no-remote opción al iniciar la sesión:

Bash
copilot --no-remote

Nota:

Las opciones --remote de la línea de comandos y --no-remote siempre tienen prioridad sobre la remoteSessions configuración en el archivo de configuración.

Acceso a una sesión desde GitHub.com

Al habilitar el control remoto, la CLI muestra un vínculo a la sesión en GitHub.com.

Use el vínculo para acceder a la sesión en el explorador web predeterminado. Debe iniciar sesión en GitHub con la misma cuenta que inició la sesión de la CLI.

También puede acceder a la sesión sin el vínculo:

  1. Inicie sesión en GitHub.com desde cualquier equipo.

  2. En la esquina superior izquierda de GitHub, haga clic en .

  3. Haga clic en Copilot.

    La sesión CLI aparece en "Sesiones recientes del agente".

  4. Opcionalmente, use el filtro Tipo situado en la parte superior derecha de la lista para mostrar solo CLI de Copilot las sesiones.

  5. Haga clic en su CLI de Copilot sesión para abrirla.

Si inició la sesión desde una copia local de un GitHub repositorio, también puede acceder a la sesión desde la pestaña Agentes de ese repositorio en GitHub.com.

Importante

Las sesiones accesibles de forma remota son específicas del usuario: solo puede acceder a sus propias CLI de Copilot sesiones. Otros GitHub usuarios no pueden acceder a las sesiones.

Acceso a una sesión desde GitHub Mobile

Una CLI de Copilot sesión está disponible en GitHub Mobile tan pronto como habilite el control remoto. Para buscar tu sesión en GitHub Mobile:

  1. Pulse el Copilot botón en la esquina inferior derecha de la pantalla.

    La sesión aparece en "Sesiones del agente".

  2. Pulse la sesión para abrirla.

Usar un código QR para abrir rápidamente una sesión en el teléfono

  1. En una sesión interactiva, escriba el /remote comando de barra diagonal para volver a reproducir los detalles de la sesión remota.

  2. Presione Ctrl+E para activar o desactivar la visualización de un código QR.

    Nota:

    Este atajo de teclado expande o contrae todos los detalles de la conversación de la sesión, no solo el código QR. Solo funciona si el campo de entrada está vacío actualmente.

  3. Escanear el código QR con su teléfono para ir directamente a la sesión en GitHub Mobile.

Impedir que la máquina vaya a dormir

Puede usar el comando de barra /keep-alive para evitar que su equipo entre en modo suspensión. Esto le permite mantener la conexión remota e interactuar con la sesión desde GitHub.com o GitHub Mobile.

En una sesión interactiva, escriba /keep-alive OPTION, donde OPTION es una de las siguientes:

  • on: evita que el equipo entre en suspensión mientras la sesión de la CLI está activa.
  • off: permite que el equipo entre en suspensión normalmente.
  • busy: evita que el equipo entre en suspensión solo mientras Copilot está ejecutando una tarea. Una vez que el agente completa una tarea, el equipo puede entrar en suspensión de manera normal. El equipo no entrará en suspensión si Copilot está esperando una respuesta del usuario para una solicitud de entrada.
  • NUMBERm, NUMBERh, or NUMBERd (por ejemplo, 30m, 8h, 1d): evita que el equipo entre en suspensión durante un período específico de minutos, horas o días. Si se proporciona un número sin un sufijo, se interpreta como minutos.

Sin pasar un OPTION, el comando /keep-alive muestra el estado actual del mantenimiento de la conexión.

Revisión de sesiones anteriores

Puede ver las sesiones antiguas CLI de Copilot en GitHub.com o en GitHub Mobile.

  1. Vaya a la lista de sesiones recientes del agente en GitHub.com o en GitHub Mobile. Consulte Accediendo a una sesión desde github.com y Accediendo a una sesión desde GitHub Mobile anteriormente en este artículo.
  2. Pulse o haga clic en la sesión que desea revisar.

En GitHub.com, un mensaje indica el copilot --resume comando que debes usar si deseas reanudar la sesión. Escriba este comando en el terminal en el equipo donde ejecutó esa sesión.

Reanudación de una sesión

Cuando se usa copilot --continue o copilot --resume para reanudar una sesión de la CLI para la que se ha habilitado el control remoto, el control remoto se vuelve a habilitar automáticamente.

Prevención del control remoto

El control remoto está deshabilitado de forma predeterminada, pero puede estar habilitado en el Copilot archivo de configuración (normalmente ~/.copilot/settings.json). Puede asegurarse de que una sesión no se puede controlar de forma remota mediante:

  • Para una sola sesión: inicie la CLI con --no-remote para evitar el control remoto para esa sesión, independientemente del valor del archivo de configuración.
  • Permanentemente: elimine el "remoteSessions": true ajuste de ~/.copilot/settings.json (o ajústelo a false).

Lectura adicional