Controlando uma CLI do GitHub Copilot sessão de outro dispositivo

O acesso remoto permite que você se conecte a uma sessão em execução CLI do Copilot de qualquer navegador ou de GitHub Mobile. Você pode exibir a saída da sessão, responder às solicitações de permissão e continuar trabalhando na sessão sem estar no computador em que a sessão está em execução.

Este artigo explica como habilitar e usar o acesso remoto. Para obter mais informações conceituais, consulte Sobre o acesso remoto às CLI do GitHub Copilot sessões.

Pré-requisitos

• O computador em que a sessão da CLI está em execução deve estar online, com a sessão ativamente em execução em um terminal.

  Dica

  Use o /keep-alive comando de barra para impedir que seu computador durma enquanto você estiver fora. Veja Como impedir que seu computador durma.

• O diretório de trabalho deve conter um repositório Git hospedado em GitHub.com. Se você não estiver em um GitHub repositório, a CLI exibirá: "Sessão remota desabilitada: não em um GitHub repositório".

Habilitando o acesso remoto para uma sessão

Você pode habilitar o acesso remoto de três maneiras:

• Com um comando de barra durante uma sessão interativa.
• Com uma opção de linha de comando quando você inicia CLI do Copilot.
• Configurando a CLI para habilitar o acesso remoto por padrão para todas as sessões interativas.

Usando o /remote comando barra

Se você já estiver em uma sessão interativa e quiser habilitar o acesso remoto, insira:

/remote

/remote

A CLI se conecta a GitHub.com e exibe detalhes para acessar a sessão remotamente — consulte Acessando uma Sessão de GitHub.com e Acessando uma Sessão de GitHub Mobile posteriormente neste artigo.

Usando a opção --remote de linha de comando

Se você acha que deseja acessar uma sessão remotamente, pode iniciar a CLI com a opção --remote de linha de comando. Isso evita a necessidade de lembrar de usar o /remote comando de barra durante a sessão.

copilot --remote

copilot --remote

Os detalhes para acessar a sessão remotamente são exibidos quando a sessão interativa é iniciada e podem ser exibidos novamente a qualquer momento usando o /remote comando barra.

Configurando o acesso remoto para sempre ser habilitado

Se você sempre quiser que suas sessões interativas da CLI sejam acessíveis remotamente, adicione o seguinte ao Copilot arquivo de configuração (normalmente localizado em ~/.copilot/config.json):

{
  "remoteSessions": true
}

{
  "remoteSessions": true
}

Para substituir essa configuração para uma sessão específica, use a opção --no-remote ao iniciar a sessão:

copilot --no-remote

copilot --no-remote

Acessando uma sessão em GitHub.com

Quando o acesso remoto está habilitado, a CLI exibe um link no formato:

https://github.com/OWNER/REPO/tasks/TASK_ID

Use este link para acessar a sessão em um navegador da Web. Você deve estar conectado GitHub com a mesma conta que iniciou a sessão da CLI.

Você também pode acessar a sessão na sua lista de sessões de agente recentes em GitHub.com:

1. No canto superior esquerdo de GitHub, clique .
2. Clique em Copilot.
3. Em "Sessões recentes do agente", clique em sua CLI do Copilot sessão para abri-la.

Acessando uma sessão de GitHub Mobile

A CLI do Copilot sessão estará disponível em GitHub Mobile assim que você habilitar o acesso remoto. Para localizar sua sessão em GitHub Mobile:

1. Toque no Copilot botão no canto inferior direito da tela.

   A sessão é listada em "Sessões do agente".

2. Toque na sessão para abri-la.

Usar um código QR para abrir rapidamente uma sessão em seu telefone

1. Em uma sessão interativa, insira o comando de barra /remote para exibir novamente os detalhes da sessão remota.

2. Pressione Ctrl+E para ativar/desativar a exibição de um código QR.

   Observação

   Esse atalho de teclado expande/recolhe todos os detalhes na conversa de sessão, não apenas o código QR. Ele só funcionará se o campo de entrada estiver vazio no momento.

3. Examine o código QR com seu telefone para ir diretamente para a sessão em GitHub Mobile.

Impedindo que seu computador durma

Você pode usar o /keep-alive comando barra para impedir que o computador durma. Isso permite que você mantenha a conexão remota e continue interagindo com a sessão a partir de GitHub.com ou GitHub Mobile.

Em uma sessão interativa, insira /keep-alive OPTION, onde OPTION está um dos seguintes:

•         `on`: impede que o computador durma enquanto a sessão da CLI está ativa.
  

•         `off`: permite que o computador durma normalmente.
  

•         `busy`: impede que o computador durma apenas enquanto Copilot estiver trabalhando em uma tarefa. Depois que o agente concluir uma tarefa, o computador poderá dormir normalmente. O computador não entrará em suspensão se Copilot estiver aguardando que você responda a uma solicitação de entrada.
  

•         `NUMBERm`, `NUMBERh`ou `NUMBERd` (por exemplo, `30m`, , `8h`): `1d`impede que o computador durma por um número específico de minutos, horas ou dias. Se um número sem sufixo for fornecido, ele será considerado como minutos.
  

Sem passar um OPTION, o comando /keep-alive exibe o status atual de keep-alive.

Retomar uma sessão com acesso remoto

Quando você encerra uma sessão que tem acesso remoto habilitado, a CLI exibe um comando de retomada que inclui --remote:

copilot --resume=SESSION_ID --remote

Use este comando para reiniciar a sessão com acesso remoto habilitado.

Da mesma forma, adicionar --remote a um copilot --continue comando retoma a sessão mais recente com acesso remoto habilitado.

Se você tiver "remoteSessions": true no Copilot arquivo de configuração, as sessões retomadas terão o acesso remoto habilitado automaticamente e você não precisará usar a opção --remote .

Impedindo o acesso remoto

O acesso remoto está desabilitado por padrão, mas pode estar habilitado no Copilot arquivo de configuração. Você pode garantir que uma sessão não esteja remotamente acessível por:

•         **Para uma única sessão**: inicie a CLI `--no-remote` para impedir o acesso remoto para essa sessão, independentemente da configuração do arquivo de configuração.
  

•         **Permanentemente**: remova a `"remoteSessions": true` configuração do arquivo de Copilot configuração (ou defina-a como `false`).