OpenBridge

Tu opencode en el celular, sin hosting: corre la app, el puente y un túnel público desde tu PC. El celular entra por la URL del túnel y vos manejás opencode (tus carpetas, modelos y chats) desde donde estés.

Proyecto nuevo e independiente, portado a Node desde OpenConex (PHP). Ya no hace falta subir nada a un hosting ni depender de uno.

Cómo funciona

[Celular] ──► URL del túnel ──► App Node en tu PC ──► .openbridge/data/ (JSON)
                                      │
                                      └──► bridge (Node) ──► opencode run

• Un solo runtime: Node 18+. La app web, la API, los datos y el puente viven en el mismo proceso/hogar.
• opencode es el único requisito externo (el motor que responde).
• Túnel con TunnelMole (gratis, sin cuenta), ngrok o Cloudflare para exponer la app a internet.

Requisitos

• Node.js 18 o superior.
• opencode instalado y autenticado: npm i -g opencode-ai.

Instalación

# opción 1: sin instalar nada (npx)
npx @danieltmn/openbridge init      # asistente: workspace, contraseña, túnel, puerto
npx @danieltmn/openbridge server    # arranca en segundo plano y muestra el estado/URL

# opción 2: instalar global
npm i -g @danieltmn/openbridge
openbridge init
openbridge server

Al arrancar (queda en segundo plano) imprime el estado con la URL pública (https://….tunnelmole.net/chat.php): abríla desde el celular y logueate con tu usuario y contraseña. Para correrlo en primer plano usá openbridge server --stream; para detenerlo, openbridge stop.

Opciones de init

--workspace <ruta>   carpeta de trabajo (donde están tus proyectos)
--name "PC 1"        nombre visible de esta computadora
--id pc1             identificador corto (default: derivado del nombre)
--port 8799          puerto local
--password <clave>   contraseña del admin inicial
--user <nombre>      nombre del admin inicial (default: admin)
--tunnel <prov>      tunnelmole | ngrok | cloudflare | none
--domain <host>      dominio fijo del túnel (ngrok)
--yes                sin preguntas (usa defaults)
--force              reconfigura aunque ya exista
--dir <ruta>         casa portable (default: directorio actual)

Actualizar

npm i -g @danieltmn/openbridge@latest     # o: npx @danieltmn/openbridge@latest …

La configuración y los datos en .openbridge/ se migran solos: el layout viejo (archivos sueltos) pasa a .openbridge/, y el username/password de una instalación de un solo usuario se convierte en el primer admin de users[] (con la misma contraseña). Por el cambio de formato de sesión, hay que volver a iniciar sesión una vez; los chats, carpetas, túnel y push se conservan.

Comandos

| Comando | Qué hace | |---|---| | openbridge init | Configura la casa (workspace, contraseña, túnel, puerto) | | openbridge passwd | Cambia la contraseña de acceso (--user <nombre>; detiene el server si corre) | | openbridge users | Usuarios y roles: list, add, remove, passwd, role, disable, enable | | openbridge server | Arranca app + puente + túnel en segundo plano y muestra el estado (--stream = primer plano) | | openbridge stop | Detiene todo: server, túnel y puente (incluido uno suelto en modo remoto) | | openbridge status | Estado, URL, puente en línea y chats (avisa si hay un puente duplicado) | | openbridge monitor | Estado en vivo; detecta puentes duplicados (--interval <s>) | | openbridge qr | Muestra la URL (pública o local) como QR para escanear desde el celular | | openbridge tunnel | Muestra o cambia el proveedor de túnel y su dominio fijo (--domain) | | openbridge logs | Logs (--follow, --server, --bridge) | | openbridge bridge | Corre solo el puente (--background = segundo plano, --stop, --status, --reload) | | openbridge join | Vincula esta PC como puente de un hub (<url> --token --id --name [--background]) | | openbridge pair | Empareja esta PC con un hub PHP por código (<url> [--id --name] [--background]) | | openbridge import | Trae data/ de OpenConex (<data-dir> [--force]) | | openbridge reset | Borra chats/datos (--session <id>, --yes) | | openbridge autostart | Arranque automático (install/remove) | | openbridge doctor | Verifica Node, opencode, configuración y puerto | | openbridge update | Busca una versión nueva en npm (--yes para actualizar) |

Casa portable

Todo vive dentro de .openbridge/ en el directorio donde corrés init (o --dir / OPENBRIDGE_HOME):

.openbridge/
  config.json    config del puente (apiUrl, token, workspace, bridgeId…)
  app.json       config de la app (usuarios, token, VAPID, puerto, túnel)
  folders.json   lista blanca de carpetas que se ven desde el celular
  data/          sesiones, mensajes, catálogo, registro de puentes, push
  logs/          server.log y bridge.log

Movés la carpeta a donde quieras y sigue funcionando (es portable). Si venías de una versión anterior con los archivos sueltos, se migran solos a .openbridge/ la primera vez que corras un comando.

Varias computadoras (hub + remotas)

La PC hub corre la app y el túnel; las demás PCs corren solo el puente y apuntan al hub. En el sidebar de la web elegís qué PC usar y ves sus proyectos y chats.

Ejemplo concreto:

1. En el hub (tiene la app y la URL pública):

   openbridge init
   openbridge server        # muestra estado, URL y QR
   openbridge status        # volvés a ver la URL cuando quieras

2. Copiá el token del puente del hub: .openbridge/app.json → bridgeToken.
3. En la PC 2 (remota):

   openbridge join https://tu-url-publica --token <bridgeToken> --id pc2 --name "PC 2"
   # acepta la base, /chat.php o /api.php; se normaliza a /api.php
   # con --no-start solo guarda la config

   (equivale a openbridge bridge --api … --token … --id … --name …, pero persiste la config para no repetir flags)
4. Abrí la URL del hub desde el celular: en el sidebar aparecen PC 1 y PC 2 para alternar.

El puente remoto solo necesita salida a internet hacia el hub; no abre puertos ni túnel propio. Para que arranque solo en cada PC: openbridge autostart install.

Sincronización (opencode es la fuente)

La conversación vive en opencode (tu PC); la web la refleja. Los mensajes que pasás por la web se guardan al instante; los que hacés en el TUI de opencode se importan por un barrido que ahora corre casi en tiempo real: el puente vigila la base de opencode (opencode.db) y sincroniza a los pocos segundos (respaldo cada 3 min). Si la sesión empezó en la web y la seguís en el TUI (o al revés), los mensajes nuevos se agregan sin duplicarse: el merge identifica cada mensaje por su id de opencode (oc_msg).

Panel del proyecto y dev run (escritorio)

En pantallas de escritorio la app muestra un panel derecho (botón ▥ en el encabezado; se puede colapsar y ajustar el ancho) con dos pestañas:

• estructura: árbol de carpetas y archivos del proyecto de la sesión abierta; al tocar un archivo se abre en el visor. Se oculta en el celular.
• preview: embebe el dev server en un iframe. Si el navegador está en la misma PC/LAN que el puente usa http://127.0.0.1:<puerto>; si estás remoto, el botón túnel levanta un TunnelMole y embebe esa URL.

Para arrancar el server de desarrollo, la vista procs detecta cómo correr cada proyecto (proc_detect): mira package.json (scripts dev/start/serve/ preview), composer.json/artisan y entrypoints PHP (public/index.php, backend/public/index.php, index.php), y ofrece los comandos como chips. Recuerda el último comando usado por carpeta.

El puente solo ejecuta binarios permitidos en bridge/config.json:

{
  "processes": {
    "enabled": true,
    "allow": ["npm", "node", "npx", "php", "python", "composer"],
    "bins": { "php": "C:\\xampp\\php\\php.exe" }
  }
}

allow es la lista blanca (ya trae php/python/composer; una config con el default viejo npm/node/npx se actualiza sola al actualizar OpenBridge). bins mapea un nombre a una ruta absoluta cuando el ejecutable no está en el PATH. Los comandos corren sin shell y con cwd dentro del workspace.

Hub en hosting PHP (URL fija, sin túnel)

Además del hub Node, OpenBridge puede correr su hub en un hosting PHP (cPanel), igual que OpenConex, y dejar que cada PC corra solo el puente:

[Celular] --HTTPS--> openbridge.tamnora.com (hub PHP)  -->  [PC] openbridge pair

• Web siempre arriba, URL fija y PWA/Web Push estables; sin túneles ni puertos.
• Cada PC se vincula con un código: en la PC openbridge pair <url> muestra un código y en la web lo ingresás en Dispositivos -> Agregar PC. Cada PC queda con su token propio (revocable); cada usuario ve solo sus PCs (el admin, todas).
• El frontend es el mismo del hub Node (se copia, no se duplica).

Guía completa (requisitos, build, subida y emparejamiento): docs/DEPLOY-PHP.md.

La PC corre el puente; para que siga tras cerrar la consola:

openbridge bridge --background     # arranca en segundo plano
openbridge bridge --status         # ¿corre?
openbridge bridge --reload         # reinicia en segundo plano (aplica cambios; --foreground para verlo)
openbridge bridge --stop           # detener
openbridge autostart install       # arranca solo al iniciar sesión (sin consola)

Un solo puente por casa. El puente tiene un lock (.openbridge/.bridge.pid): un segundo intento se rechaza. Además, openbridge server para cualquier puente suelto y arranca el suyo, y openbridge stop cierra todo (server + puente). Para verificar: openbridge status, openbridge doctor o openbridge monitor.

Túnel y URL estable

Proveedores (--tunnel o openbridge tunnel <prov>): tunnelmole (gratis, sin cuenta), ngrok (cuenta + authtoken; admite dominio fijo) y cloudflare (quick tunnel). Ver/cambiar sin reconfigurar todo:

openbridge tunnel                                   # estado actual
openbridge tunnel ngrok --domain mi-pc.ngrok.app    # URL fija (recomendado)
openbridge stop && openbridge server                # reiniciar para aplicar

Con URL aleatoria la PWA y el push no persisten entre reinicios (están atados al origen). Para una URL estable usá ngrok con dominio fijo (o un named tunnel de Cloudflare). Escaneá el QR de openbridge status/openbridge qr para abrirla en el celular.

Avisos push

Las claves VAPID se generan solas en init. Con URL de túnel aleatoria la suscripción no persiste entre reinicios (el push está atado al origen); la app la vuelve a registrar cuando la abrís en la URL nueva. Para que sea estable, usá una URL fija (ngrok con --domain).

MCP

La web tiene una vista mcp y el chat acepta /mcp: muestran los servidores MCP de opencode y su estado (opencode mcp list). El comando corre en la PC del puente, así que refleja la configuración de opencode de esa computadora.

Seguridad

• La app escucha solo en 127.0.0.1; el túnel la expone a internet.
• Login con usuario y contraseña (scrypt), cookie firmada HttpOnly + SameSite=Lax, CSRF y rate limit (5 intentos / 15 min por IP+usuario); token del puente autogenerado.
• La cookie usa Secure cuando el pedido llega por HTTPS desde loopback (el túnel); no se confía en X-Forwarded-Proto de otros orígenes.
• Respuestas con Content-Security-Policy (orígenes externos, objetos y frame-ancestors bloqueados; frame-src permite embeber la vista previa del dev server), X-Content-Type-Options: nosniff, X-Frame-Options: DENY y Referrer-Policy: no-referrer.
• El túnel es público mientras corre: detenelo (openbridge stop) cuando no lo uses y mantené la contraseña fuerte.

Usuarios y roles

Cada persona entra con usuario y contraseña. Hay dos roles:

• admin: todo (crear/borrar chats, revertir cambios, procesos, túneles y administrar usuarios).
• user: chat, archivos, cambios y búsqueda; no puede borrar chats, revertir cambios ni correr procesos/túneles.

Se administran desde la PC con la CLI (los cambios requieren reiniciar el server):

openbridge users list
openbridge users add ana --role user --password <clave>
openbridge users passwd ana
openbridge users role ana admin
openbridge users disable ana      # enable para reactivar
openbridge users remove ana
openbridge passwd --user admin    # cambia la clave de un usuario

init --user <nombre> crea el admin inicial. La contraseña se guarda con scrypt, y cambiar una clave invalida las sesiones abiertas de ese usuario. El último admin no se puede borrar, degradar ni deshabilitar. Cada mensaje guarda quién lo envió (se ve en el chat).

Estado

Proyecto en desarrollo. Ya funciona: init, server (segundo plano; --stream en primer plano), stop, status, qr, tunnel, logs (--follow), bridge (con flags), passwd, users, import, reset, autostart, doctor; login multiusuario con roles admin/user y rate limit; API completa y SSE; catálogo por PC; Web Push; túnel (TunnelMole/ngrok/cloudflare); y en la web: chat con streaming, adjuntar imagen, dictado por voz, plantillas de prompts, medidor de contexto de la sesión activa (barra y % en verde/amarillo/naranja/rojo) y costo por sesión en la barra de estado, vista de archivos, panel derecho de estructura y vista previa (escritorio), procs con detección de dev run por proyecto, vista de cambios (git status/diff) con revertir, búsqueda global, sesiones de opencode y autor en cada mensaje. Tests en npm test (61).

Licencia

MIT.