antigravity-remote-backend
Servidor backend en Node.js para control remoto seguro de Antigravity desde Android, usando WebSockets directos y Cloudflare Tunnels sin VPN ni port forwarding.
Ficha actualizada 24 sept 2026, 7:33 · upstream 24 sept 2026, 7:28 · release sin release detectada
Qué es antigravity-remote-backend
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene un servidor backend en Node.js diseñado específicamente para actuar como puente WebSocket nativo entre el Language Server local de Antigravity y la aplicación móvil oficial. El sistema permite enviar comandos, adjuntar imágenes y observar el flujo de pensamiento de la IA en tiempo real mediante una conexión RPC directa que replica el comportamiento del IDE oficial.
La arquitectura incluye un sistema robusto de descubrimiento automático del servidor local (auto-detecta puerto y token CSRF), gestión segura de dispositivos mediante QR con autenticación JWT, y exposición al internet vía Cloudflare Tunnels con supervisión de salud automática. El backend soporta actualizaciones seguras sin interrumpir sesiones activas y protege forks personalizados deshabilitando actualizaciones automáticas remotas.
Además del control móvil, ofrece un panel de administración web para gestión de proyectos compartidos, aislamiento de dispositivos por proyecto y una interfaz de chat web para usuarios de escritorio. Incluye notificaciones push locales mediante servicio en primer plano y carga inteligente de historial en chunks para mantener el rendimiento.
- Control remoto de agentes de IA desde Android sin VPN ni port forwarding
- Gestión centralizada de dispositivos emparejados y revocación de acceso
- Compartir proyectos específicos con invitados mediante tokens JWT restringidos
- Chat web para usuarios de escritorio con aislamiento por proyecto
- Conexión WebSocket persistente directa al Language Server local
- Autenticación segura vía QR y tokens JWT en lugar de whitelists IP
- Descubrimiento automático del servidor local sin configuración manual
- Gestión granular de permisos por proyecto con sandboxing de comandos
- Dependencia de Firebase Realtime Database para descubrimiento de URL (opcional pero recomendado)
- Requiere Cloudflare Tunnel para acceso externo sin port forwarding
- Actualizaciones automáticas deshabilitadas en forks personalizados mediante variable de entorno
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar npm run build y configurar .env con FIREBASE_DATABASE_URL si se usa descubrimiento automático. Iniciar el túnel con scripts/start_tunnel.ps1 o usar PM2 para arranque automático. Asegurar que el firewall permita tráfico en puerto 8080 local antes de exponer mediante Cloudflare.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.