Repolode
Xpropel

Xpropel/Pi-Remote

Control remoto del agente de programación de terminal pi: refleja sesiones en tiempo real en un navegador o teléfono y permite enviar mensajes o comandos a través de un relay autohospedado.

Estrellas
306
Forks
8
Issues abiertos
0
Último commit
ayer

¿Qué es?

Pi-Remote se conecta a una sesión de terminal pi en ejecución mediante la API oficial de extensiones de pi, sin modificar el código fuente de pi ni tomar el control de la terminal. La sesión sigue ejecutándose en el proceso local de pi, mientras que un navegador muestra una réplica en tiempo real. Desde el navegador puedes enviar mensajes, cambiar de modelo y de nivel de razonamiento, compactar el contexto, crear o bifurcar sesiones y recorrer el árbol de sesiones.

El sistema tiene tres componentes: una extensión de sincronización que se ejecuta dentro de pi, un servicio relay de Node que gestiona la autenticación y el reenvío, y una interfaz web servida por el relay. Varias máquinas pueden conectarse a un mismo relay, y cada dispositivo solo es accesible mientras su ventana de conexión esté abierta. El modo serverless ejecuta el relay en tu propio equipo, y los teléfonos se conectan a través de la misma red Wi-Fi o mediante un Cloudflare Tunnel temporal.

El proyecto está diseñado para uso personal y de un solo usuario. La ejecución remota de bash está desactivada de forma predeterminada, y la extensión y el visor usan tokens distintos. El contenido de las conversaciones no se guarda, salvo que se habilite la persistencia.

Funciones clave

  • 01Duplicación en tiempo real de la salida de terminal de pi, las llamadas a herramientas y el estado en el navegador
  • 02Envío remoto de mensajes, con opciones para ponerlos en cola o dirigirlos mientras pi está ocupado
  • 03Cambio remoto de modelo y nivel de razonamiento, compactación manual y navegación por el árbol de sesiones
  • 04Vinculación de dispositivos mediante códigos QR y compatibilidad con varias máquinas conectadas
  • 05Modo LAN serverless con Cloudflare Tunnel opcional bajo demanda
  • 06Diseños independientes para escritorio y móvil, con varios temas visuales

Casos de uso

  • Comprobar desde el teléfono cómo avanza una tarea de larga duración de un agente de programación
  • Responder a las solicitudes de pi cuando no estás frente al escritorio
  • Controlar sesiones de pi en varias máquinas desde un único panel del navegador

Inicio rápido

  1. 1

    Instala el agente de programación de terminal pi (requiere Node 22.18 o posterior).

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

    Instala las dependencias de Pi-Remote en la carpeta del proyecto.

    npm install
  3. 3

    Inicia el relay en tu equipo (interfaz web en el puerto 7002).

    npm run relay

Antes de usarlo

  • El agente de programación pi debe instalarse por separado; Pi-Remote no lo incluye.
  • Para usar varios dispositivos a través de un relay necesitas un servidor que administres, salvo en el modo de bucle local.
  • Está diseñado para uso personal y de un solo usuario; no cuenta con un sistema de permisos multiusuario.
  • Cualquiera que tenga el viewer token puede enviar mensajes y comandos a pi, por lo que debes protegerlo.

En colecciones

Temas

Preguntas frecuentes

¿Qué es Pi-Remote?
Control remoto del agente de programación de terminal pi: refleja sesiones en tiempo real en un navegador o teléfono y permite enviar mensajes o comandos a través de un relay autohospedado. Pi-Remote se conecta a una sesión de terminal pi en ejecución mediante la API oficial de extensiones de pi, sin modificar el código fuente de pi ni tomar el control de la terminal. La sesión sigue ejecutándose en el proceso local de pi, mientras que un navegador muestra una réplica en tiempo real. Desde el navegador puedes enviar mensajes, cambiar de modelo y de nivel de razonamiento, compactar el contexto, crear o bifurcar sesiones y recorrer el árbol de sesiones.
¿Pi-Remote es gratuito? ¿Qué licencia tiene?
Pi-Remote es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Pi-Remote sigue mantenido?
Mantenimiento activo. El último commit de Pi-Remote fue el 5 nov 2026.
¿Para qué puedo usar Pi-Remote?
Comprobar desde el teléfono cómo avanza una tarea de larga duración de un agente de programación Responder a las solicitudes de pi cuando no estás frente al escritorio Controlar sesiones de pi en varias máquinas desde un único panel del navegador
¿Cómo se instala Pi-Remote?
Instala el agente de programación de terminal pi (requiere Node 22.18 o posterior).: npm install -g @earendil-works/pi-coding-agent Instala las dependencias de Pi-Remote en la carpeta del proyecto.: npm install Inicia el relay en tu equipo (interfaz web en el puerto 7002).: npm run relay
¿Dónde consigo Pi-Remote?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Xpropel/Pi-Remote

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados