Sessão remota

A sessão remota deixa você conduzir uma sessão a partir de outra tela — o navegador de um celular ou de outro computador — enquanto o trabalho continua acontecendo na sua máquina. O ponto central: o seu app (Desktop ou TUI) continua sendo o runtime; a Platform apenas faz o relay das mensagens. Nada executa no servidor.

Como funciona

O cliente remoto envia o prompt; a Platform só repassa; o seu app executa localmente e o streaming volta para as duas telas.

1. O seu app local gera um código de pareamento de curta duração e uma URL.
2. No outro dispositivo, você abre essa URL, faz login e cola o código.
3. A partir daí, os prompts digitados no cliente remoto rodam no seu PC, e o streaming da resposta volta para as duas telas.

Como a execução é local, a sessão remota tem o mesmo acesso (e os mesmos limites) que a sua sessão normal — incluindo o seu workspace e o cofre.

Parear no Desktop

1. Clique na pílula Remote (no cabeçalho).
2. Selecione Create pair. O app exibe um código (formato Crockford) com uma contagem regressiva de 30 segundos e uma URL para compartilhar (<host>/remote).
3. Use Copy code / Copy URL para enviar ao outro dispositivo.
4. No outro dispositivo, abra a URL, faça login e cole o código antes de ele expirar.

Para encerrar o pareamento, use Revoke.

Parear na TUI

1. Digite /remote. A TUI mostra um código de pareamento válido por 30 segundos.
2. No navegador do outro dispositivo, abra <host>/remote, faça login e cole o código.
3. Use /remote status para ver o estado da conexão e /remote stop para encerrar.

Veja todos os comandos em Comandos da TUI.

Segurança

A sessão remota foi desenhada para ser segura por construção:

• Não expõe os seus arquivos. O cliente remoto envia prompts e recebe respostas; ele não navega no seu disco. A execução — e o acesso a arquivos — continua acontecendo apenas no seu app local.
• Um par ativo por vez. Só existe um pareamento simultâneo; criar um novo (ou usar Revoke) encerra o anterior.
• Requer login. Tanto o seu app quanto o cliente remoto precisam estar autenticados com a sua identidade da organização. Veja Identidade.
• Código efêmero. O código de pareamento expira em 30 segundos; depois disso é preciso gerar um novo.

A Platform nunca executa

O papel da Platform aqui é estritamente de relay: ela repassa mensagens entre o cliente remoto e o seu app. O agente, as ferramentas e os arquivos vivem na sua máquina. Por isso a sessão remota só funciona enquanto o seu app está aberto e conectado.

Quando usar

A sessão remota brilha quando o trabalho precisa rodar na sua máquina, mas você quer acompanhá-lo de outro lugar:

• Continuar de longe — disparar um prompt e acompanhar a resposta pelo celular enquanto se afasta do computador.
• Tela secundária — deixar a execução rolando no app local e ler a transcrição confortavelmente em outro dispositivo.
• Tarefas demoradas — iniciar uma rotina ou uma geração longa e checar o progresso sem voltar ao teclado.

Quando o pareamento falha

Sintoma	Causa	O que fazer
O código não é aceito	Expirou (vale 30s)	Gere um novo (Create pair / /remote) e cole rápido.
"Já existe um par ativo"	Só um pareamento por vez	Use Revoke (Desktop) ou /remote stop (TUI) e pareie de novo.
Pede login no cliente remoto	A sessão remota requer login	Faça login no navegador antes de colar o código.
Nada acontece após parear	O app local fechou ou perdeu conexão	Verifique se o app está aberto e online — ele é o runtime.

Mais sintomas gerais em Solução de problemas.

Remoto ≠ chat hospedado

A sessão remota não é o mesmo que o chat no navegador. No chat web, o agente roda no servidor. Na sessão remota, o cliente no navegador é só um controle: o agente continua rodando no seu app local. Por isso o remoto enxerga o seu workspace e o chat hospedado, não.

Veja também

🏗️Arquitetura

Onde o Engine roda e o papel da Platform.

Abrir →💬Sessões

O que é uma sessão e como ela é preservada.

Abrir →🪪Identidade

O login na organização e por que você não gerencia chaves.

Abrir →