Como o Pontia funciona
O Pontia separa a execução dos agentes do acesso remoto. Os agentes de programação rodam no seu dispositivo, junto com as suas ferramentas de desenvolvimento e os arquivos do projeto. O Pontia adiciona um plano de controle local e um caminho criptografado até o Remote Dashboard hospedado.
pontiadPlano de controle Agent client WorkspaceArquivos e ferramentasO plano de controle local
O serviço pontiad roda no seu dispositivo. Ele coordena as sessões dos agentes, se comunica com os agent clients compatíveis, como pi, Codex, Claude Agent e agentes ACP, e serve o Local Dashboard e a API.
O agent client executa comandos usando os arquivos e as ferramentas instalados no seu dispositivo.
Remote Dashboard e Local Dashboard
Faça login no Remote Dashboard hospedado pelo Pontia Cloud e selecione um dispositivo registrado. O navegador e o dispositivo estabelecem uma sessão com criptografia de ponta a ponta pelo Edge selecionado, que retransmite o texto cifrado.
Para acesso direto no dispositivo, o Local Dashboard se conecta ao pontiad pelo endereço de loopback.
Pontia Cloud e Edge
O Pontia Cloud gerencia o login dos usuários, os dispositivos registrados, a autorização de conexões e a descoberta de Edges. Os agentes e os arquivos do projeto ficam no seu dispositivo.
Um Edge fornece a conectividade entre um navegador remoto e um dispositivo. Você pode usar um Edge oficial ou implantar o seu próprio. A auto-hospedagem muda onde o tráfego criptografado é retransmitido; o Pontia Cloud continua fornecendo os serviços de conta, registro de dispositivos e autorização.
Sessions e agent clients
Uma Session é a visão persistente do Pontia sobre uma unidade de trabalho de um agente. O agent client selecionado executa o trabalho, enquanto o Pontia registra estado suficiente para exibir e controlar a Session pelo Dashboard.
Pelo Dashboard, você pode criar, acompanhar, continuar e interromper Sessions de agentes compatíveis que rodam no seu dispositivo.
Limites dos dados
| Componente | Responsabilidade | Acesso aos arquivos do projeto |
|---|---|---|
Seu dispositivo e o pontiad | Executa o plano de controle local e coordena os agentes | Sim, dentro das Workspaces expostas ao Pontia |
| Agent client | Executa o trabalho do agente com ferramentas locais | De acordo com as permissões locais do cliente |
| Navegador | Apresenta o Dashboard e envia controles | Sem acesso direto ao sistema de arquivos; exibe os dados retornados pelo dispositivo |
| Edge | Retransmite o tráfego do Dashboard com criptografia de ponta a ponta | Não |
| Pontia Cloud | Cuida da identidade, do registro de dispositivos e da autorização remota | Não |
Para configurar um dispositivo, continue em Primeiros passos. Para se conectar a partir de outro dispositivo, veja Acesso remoto.