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

Habilite o controle remoto para uma CLI do Copilot sessão para que você possa monitorar o progresso, responder aos prompts e continuar trabalhando em GitHub.com ou GitHub Mobile.

Neste artigo

O controle 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 controle remoto. Para obter mais informações conceituais, consulte Sobre o controle remoto de 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 entre em suspensão 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 controle remoto para uma sessão

Você pode habilitar o controle 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 controle remoto por padrão para todas as sessões interativas.

Usar o comando barra /remote

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

Copilot prompt
/remote on

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.

Você pode usar o comando de barra invertida /remote sem um argumento para verificar o status atual do controle remoto ou exibir novamente os detalhes de acesso remoto, caso o controle remoto esteja habilitado no momento. Se você quiser encerrar a conexão remota da sessão atual, insira /remote off.

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.

Bash
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 controle 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ções (normalmente localizado em ~/.copilot/settings.json):

JSON
{
  "remoteSessions": true
}

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

Bash
copilot --no-remote

Observação

As opções --remote de linha de comando e --no-remote sempre têm precedência sobre a remoteSessions configuração no arquivo de configurações.

Acessando uma sessão em GitHub.com

Quando você habilita o controle remoto, a CLI exibe um link para a sessão em GitHub.com.

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

Você também pode acessar a sessão sem o link:

  1. Conecte-se a GitHub.com em qualquer computador.

  2. No canto superior esquerdo de GitHub, clique .

  3. Clique em Copilot.

    Sua sessão da CLI está listada em "Sessões de agente recentes".

  4. Opcionalmente, use o filtro Tipo no canto superior direito da lista para mostrar apenas CLI do Copilot sessões.

  5. Clique em sua CLI do Copilot sessão para abri-la.

Se você iniciou a sessão a partir de uma cópia local de um GitHub repositório, também poderá acessar a sessão na guia Agentes desse repositório.GitHub.com

Importante

Sessões acessíveis remotamente são específicas do usuário: você só pode acessar suas próprias CLI do Copilot sessões. Outros GitHub usuários não podem acessar suas sessões.

Acessando uma sessão em GitHub Mobile

Uma CLI do Copilot sessão estará disponível GitHub Mobile assim que você habilitar o controle 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 entre em suspensão. 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, NUMBERhou NUMBERd (por exemplo, 30m, , 8h): 1dimpede 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.

Revisão das sessões anteriores

Você pode exibir sessões antigas CLI do Copilot em GitHub.com ou em GitHub Mobile.

  1. Vá para sua lista de sessões de agente recentes em GitHub.com ou em GitHub Mobile. Consulte Acessando uma sessão do github.com e Acessando uma sessão do GitHub Mobile anteriormente neste artigo.
  2. Clique ou toque na sessão que você deseja examinar.

Em GitHub.com, uma mensagem informa o comando copilot --resume a ser usado para retomar a sessão. Insira este comando em seu terminal no computador em que você executou essa sessão.

Retomando uma sessão

Quando você usa copilot --continue ou copilot --resume para retomar uma sessão da CLI para a qual o controle remoto tinha sido habilitado, o controle remoto é reabilitado automaticamente.

Impedindo o controle remoto

O controle remoto está desabilitado por padrão, mas pode estar habilitado no Copilot arquivo de configurações (normalmente ~/.copilot/settings.json). Você pode garantir que uma sessão não seja controlável remotamente por:

  • Para uma única sessão: inicie a CLI com --no-remote para impedir o controle remoto dessa sessão, independentemente do valor do arquivo de configurações.
  • Permanentemente: remova a configuração de "remoteSessions": true de ~/.copilot/settings.json (ou defina-a como false).

Leitura adicional