Repolode
Enviar
Xpropel

Xpropel/Pi-Remote

Controle remoto do agente de programação pi no terminal: espelhe sessões ao vivo no navegador ou celular e envie mensagens ou comandos por um relay auto-hospedado.

Ver no GitHub
Estrelas
307
Forks
10
Issues abertas
0
Último commit
anteontem

O que é?

O Pi-Remote se conecta a uma sessão pi em execução no terminal por meio da API oficial de extensões do pi, sem modificar o código-fonte do pi nem assumir o controle do terminal. A sessão continua rodando no processo local do pi, enquanto o navegador exibe um espelhamento em tempo real. Pelo navegador, você pode enviar mensagens, trocar de modelo e nível de raciocínio, compactar o contexto, criar ou bifurcar sessões e navegar pela árvore de sessões.

O sistema tem três partes: uma extensão de sincronização executada dentro do pi, um serviço relay em Node que cuida da autenticação e do encaminhamento, e uma interface web servida pelo relay. Várias máquinas podem se conectar a um único relay, e cada dispositivo só fica acessível enquanto sua janela de conexão estiver aberta. No modo serverless, o relay roda no seu próprio computador, e os celulares se conectam pela mesma rede Wi-Fi ou por meio de um Cloudflare Tunnel temporário.

O projeto foi desenvolvido para uso pessoal e individual. O bash remoto fica desativado por padrão, e a extensão e o visualizador usam tokens separados. O conteúdo das conversas não é persistido, a menos que a persistência seja ativada.

Recursos principais

  • 01Espelhamento em tempo real da saída do terminal pi, das chamadas de ferramentas e do status no navegador
  • 02Envio remoto de mensagens, com opção de enfileirar ou direcionar enquanto o pi está ocupado
  • 03Troca remota de modelo e nível de raciocínio, compactação manual e navegação pela árvore de sessões
  • 04Vinculação de dispositivos por QR code e suporte a várias máquinas conectadas
  • 05Modo LAN serverless com opção de ativar um Cloudflare Tunnel sob demanda
  • 06Layouts separados para desktop e celular, com vários temas visuais

Casos de uso

  • Acompanhar pelo celular uma tarefa de programação de longa duração executada por um agente
  • Responder aos prompts do pi quando estiver longe da mesa
  • Controlar sessões do pi em várias máquinas por um único painel no navegador

Início rápido

  1. 1

    Instale o agente de programação de terminal pi (requer Node 22.18 ou superior).

    npm install -g @earendil-works/pi-coding-agent
  2. 2

    Instale as dependências do Pi-Remote na pasta do projeto.

    npm install
  3. 3

    Inicie o relay na sua máquina (interface web na porta 7002).

    npm run relay

Antes de usar

  • O agente de programação pi precisa ser instalado separadamente; ele não está incluído no Pi-Remote.
  • Para usar vários dispositivos por meio de um relay, é necessário ter um servidor sob sua administração, exceto no modo de loop local.
  • Foi desenvolvido para uso pessoal e individual, sem sistema de permissões para vários usuários.
  • Qualquer pessoa com o viewer token pode enviar mensagens e comandos ao pi; por isso, proteja o token.

Em coleções

Frameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAApps auto-hospedados

Tópicos

#ai-agent#coding-agent#remote-control#web-terminal#websocket#self-hosted#typescript#nodejs#developer-tools#pi

Perguntas frequentes

O que é Pi-Remote?
Controle remoto do agente de programação pi no terminal: espelhe sessões ao vivo no navegador ou celular e envie mensagens ou comandos por um relay auto-hospedado. O Pi-Remote se conecta a uma sessão pi em execução no terminal por meio da API oficial de extensões do pi, sem modificar o código-fonte do pi nem assumir o controle do terminal. A sessão continua rodando no processo local do pi, enquanto o navegador exibe um espelhamento em tempo real. Pelo navegador, você pode enviar mensagens, trocar de modelo e nível de raciocínio, compactar o contexto, criar ou bifurcar sessões e navegar pela árvore de sessões.
Pi-Remote é gratuito? Qual é a licença?
Pi-Remote é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Pi-Remote ainda é mantido?
Manutenção ativa. O último commit de Pi-Remote foi em 5 de nov. de 2026.
Para que posso usar Pi-Remote?
Acompanhar pelo celular uma tarefa de programação de longa duração executada por um agente Responder aos prompts do pi quando estiver longe da mesa Controlar sessões do pi em várias máquinas por um único painel no navegador
Como instalar Pi-Remote?
Instale o agente de programação de terminal pi (requer Node 22.18 ou superior).: npm install -g @earendil-works/pi-coding-agent Instale as dependências do Pi-Remote na pasta do projeto.: npm install Inicie o relay na sua máquina (interface web na porta 7002).: npm run relay
Onde consigo Pi-Remote?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Xpropel/Pi-Remote

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados