El acceso 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 acceso remoto. Para obtener más información conceptual, consulte Acerca del acceso remoto a CLI de GitHub Copilot sesiones.
Nota:
- El acceso remoto a las sesiones de CLI de Copilot está en versión preliminar pública y está sujeto a cambios.
- Actualmente, el acceso móvil solo está disponible en la versión beta más reciente de GitHub Mobile. Puede unirse al programa de prueba para GitHub Mobile a través de Apple TestFlight para iOS y Google Play para Android.
Prerrequisitos
-
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
Utilice el
/keep-alivecomando de barra diagonal para evitar que la máquina entre en suspensión mientras no esté presente. 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 acceso remoto para una sesión
Puede habilitar el acceso remoto de tres maneras:
- Con un comando de barra 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 acceso remoto de forma predeterminada para todas las sesiones interactivas.
Uso del /remote comando de barra diagonal
Si ya está en una sesión interactiva y desea habilitar el acceso remoto, escriba:
/remote
/remote
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.
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.
copilot --remote
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 acceso 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/config.json):
{
"remoteSessions": true
}
{
"remoteSessions": true
}
Para invalidar esta configuración para una sesión determinada, use la --no-remote opción al iniciar la sesión:
copilot --no-remote
copilot --no-remote
Nota:
Las opciones --remote de 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
Cuando se habilita el acceso remoto, la CLI muestra un vínculo con el formato :
https://github.com/OWNER/REPO/tasks/TASK_ID
Use este vínculo para acceder a la sesión en un explorador web. 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 desde la lista de sesiones recientes del agente en GitHub.com:
- En la esquina superior izquierda de GitHub, haga clic en .
- Haga clic en Copilot.
- En "Sesiones recientes del agente", haga clic en la CLI de Copilot sesión para abrirla.
Importante
Las sesiones 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 acceso remoto. Para buscar tu sesión en GitHub Mobile:
-
Pulse el Copilot botón en la esquina inferior derecha de la pantalla.
La sesión aparece en "Sesiones del agente".
-
Pulse la sesión para abrirla.
Usar un código QR para abrir rápidamente una sesión en el teléfono
-
En una sesión interactiva, escriba el
/remotecomando de barra diagonal para volver a reproducir los detalles de la sesión remota. -
Presione Ctrl+E para activar o desactivar la visualización de un código QR.
Nota:
Este método abreviado de teclado expande o contrae todos los detalles de la conversación de sesión, no solo el código QR. Solo funciona si el campo de entrada está vacío actualmente.
-
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 /keep-alive comando slash para evitar que el equipo entre en 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`: impide que la máquina entre en suspensión mientras la sesión de la interfaz de línea de comandos está activa. -
`off`: permite que la máquina entre en suspensión de manera normal. -
`busy`: Solo impide que la máquina se suspenda mientras Copilot trabaja en una tarea. Una vez que el agente completa una tarea, la máquina puede ir a suspensión de manera habitual. La máquina no se suspenderá si Copilot está esperando su respuesta a una solicitud de entrada de su parte. -
`NUMBERm`, `NUMBERh`, o `NUMBERd` (por ejemplo, `30m`, `8h`, `1d`): impide que la máquina entre en suspensión durante un número 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 /keep-alive comando muestra el estado de mantenimiento activo actual.
Reanudación de una sesión con acceso remoto
Al apagar una sesión que tenga habilitado el acceso remoto, la CLI muestra un comando resume que incluye --remote:
copilot --resume=SESSION_ID --remote
Use este comando para reiniciar la sesión con el acceso remoto habilitado.
Del mismo modo, agregar --remote a un copilot --continue comando reanuda la sesión más reciente con el acceso remoto habilitado.
Si tiene "remoteSessions": true en el Copilot archivo de configuración, las sesiones reanudadas tendrán el acceso remoto habilitado automáticamente y no es necesario usar la --remote opción .
Impedir el acceso remoto
El acceso remoto está deshabilitado de forma predeterminada, pero puede estar habilitado en el Copilot archivo de configuración. Puede asegurarse de que una sesión no es accesible de forma remota:
-
**Para una sola sesión**: inicie la CLI con `--no-remote` para evitar el acceso remoto para esa sesión, independientemente de la configuración del archivo de configuración. -
**Permanentemente**: quite el ajuste de `"remoteSessions": true` del archivo de configuración de Copilot (o establézcalo en `false`).