--- title: En el celular description: Usa Lampson, el agente de programación con IA, desde el teléfono: instálalo como app, entra con una passkey y conéctalo a tu PC con un túnel de Synsema (dirección fija, arranca con la PC) o a tu VPS con tu propio dominio. --- # En el celular Lampson corre en tu PC o en tu servidor; el teléfono es el control remoto. Se instala como app (PWA), entra con la huella o la cara, y ves y usas tus espacios de trabajo como en el navegador de la PC. ## 1. Que el teléfono llegue a Lampson El teléfono necesita una dirección **https** que llegue al hub (`127.0.0.1:8080`). Elige una: | | Para quién | Dirección | |---|---|---| | **Túnel de Synsema** | tu PC de casa, recomendado | fija, `…-tunnel.synsema.app`; arranca con la PC | | **Túnel rápido** | probar en 1 minuto | cambia en cada arranque | | **Túnel persistente** | tu PC de casa, todos los días | fija, en tu dominio | | **Dominio propio** | un VPS con IP pública | fija, en tu dominio | ### Túnel de Synsema (recomendado) Lampson corre sobre Synsema, y la plataforma de Synsema tiene túneles: tu PC en una dirección **fija** `https://-tunnel.synsema.app`, sin abrir puertos, sin tocar DNS y sin dominio propio. La PC abre una sola conexión de salida y todo llega por ella: páginas, eventos en vivo y la terminal (WebSocket). **1.** Instala el CLI de la plataforma, `syn`, e inicia sesión (una vez por equipo; alcanza el plan gratuito): ```sh curl -fsSL https://synsema.com/cli/install.sh | sh # macOS, Linux irm https://synsema.com/cli/install.ps1 | iex # Windows (PowerShell) syn login # syn signup si todavía no tienes cuenta ``` **2.** Pon el hub en esa dirección y deja que la PC lo mantenga arriba: ```sh syn tunnel 8080 --name lampson --service ``` Imprime la dirección, que es siempre la misma para esta PC y el nombre `lampson`. Con `--service` el túnel **arranca con el equipo**, sin terminal abierta: la carpeta Inicio en Windows (al iniciar sesión), una unidad de systemd en Linux, un LaunchAgent en macOS. Sin `--service` vive mientras viva su terminal. **3.** Haz que el hub también arranque solo: `lampson --install`. **4.** Empareja el teléfono desde la terminal: `lampson --pair https://-tunnel.synsema.app` (o desde la PC, paso 2 más abajo). - La dirección no cambia, así que la passkey sigue sirviendo después de reiniciar. - Si la PC está apagada, la dirección responde `503` con `X-Synsema-Tunnel: offline`, y la app muestra «Tu PC no responde» en su lugar. - `syn tunnel service list` muestra los túneles que se mantienen arriba y su último estado; `syn tunnel service remove lampson` lo detiene (la dirección sigue siendo tuya); `syn tunnel release lampson` la libera. Registro: `~/.synsema/tunnels/lampson.log`. - Planes: Free tiene 3 direcciones y 5 GB al mes, y un navegador ve una página de aviso la primera vez que abre la dirección (se acepta una vez; las peticiones de la propia app nunca la ven). Pro no tiene aviso y permite un nombre propio: `--subdomain milampson` → `https://milampson.synsema.app` — un nombre nuevo es otro dominio para la passkey, así que hay que emparejar de nuevo. - Haz el túnel al hub (`8080`), nunca al puerto de un espacio de trabajo: el hub es el que pide la passkey. ### Túnel rápido (para probar) Instala [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) (en Windows: `winget install Cloudflare.cloudflared`) y ejecuta: ```sh cloudflared tunnel --url http://localhost:8080 ``` Imprime una dirección `https://….trycloudflare.com`. No necesitas cuenta ni dominio. La dirección cambia cada vez que lo vuelves a lanzar, y la passkey queda atada a la dirección: al cambiar, hay que emparejar de nuevo. ### Túnel persistente (tu PC, siempre) Para una dirección fija que sobreviva a reinicios. Necesitas una cuenta gratis de Cloudflare con tu dominio agregado (Cloudflare administra su DNS). **1.** En el panel de Cloudflare: **Zero Trust → Networks → Tunnels → Create a tunnel**, tipo *Cloudflared*, nombre `lampson`. **2.** Copia el comando de instalación que te muestra y ejecútalo en tu PC. Deja el túnel instalado como servicio del sistema, así arranca solo con la PC: ```sh cloudflared service install # Windows: en una terminal como administrador sudo cloudflared service install # Linux ``` **3.** En **Public Hostname** agrega: subdominio `lampson`, tu dominio, servicio `HTTP` → `localhost:8080`. **4.** Que el hub también arranque solo: `lampson --install` (en Windows, al iniciar sesión). Tu dirección queda en `https://lampson.tudominio.com`. Si la PC está apagada, la app lo dice («Tu PC no responde») en vez de mostrar el error del túnel. Si prefieres la terminal a la página de Cloudflare: ```sh cloudflared tunnel login cloudflared tunnel create lampson cloudflared tunnel route dns lampson lampson.tudominio.com cloudflared tunnel run --url http://localhost:8080 lampson ``` ### Dominio propio (VPS) Si Lampson corre en un servidor con IP pública, no hace falta túnel: Synsema sirve tu dominio con HTTPS directamente. ```sh lampson --domain lampson.tudominio.com --email tu@tudominio.com ``` Detalles y requisitos en [Docker y servidores](/es/docs/deploy). ## 2. Emparejar el teléfono **1.** En la PC, abre `http://127.0.0.1:8080` → **dispositivos** → *emparejar dispositivo*. **2.** Pega la dirección https (el túnel o tu dominio; con `--domain` ya está puesta) y toca **Generar QR**. **3.** Escanéalo con la cámara del teléfono y toca **Crear passkey**: huella, cara o el bloqueo de pantalla. El QR vale 5 minutos y sirve una sola vez. La passkey se guarda en el teléfono (o en tu gestor, como el de Google o iCloud). Lampson guarda solo la clave pública. ### En un VPS: desde la terminal En un servidor no hay navegador donde abrir `127.0.0.1:8080`, y el emparejamiento solo se inicia desde la propia máquina (a propósito: así nadie puede emparejarse entrando a tu dominio). Conéctate por SSH y corre: ```sh lampson --pair ``` Aparece un **QR en la terminal**: apúntale con la cámara del teléfono y toca **Crear passkey**. Vale 5 minutos y sirve una sola vez; debajo queda el link por si prefieres abrirlo a mano. Con `--domain` la dirección ya está puesta; si no, pásala: `lampson --pair https://tu-dominio`. Sirve igual en tu PC, con un túnel. Si la dirección guardada no responde — por ejemplo un túnel de cloudflare que ya cerraste: cada uno trae una dirección nueva —, te lo avisa en vez de mostrar un QR que no llevaría a ningún lado. Otra forma, sin `--pair`: un túnel SSH (`ssh -L 8080:127.0.0.1:8080 usuario@tu-vps`) y abrir `http://127.0.0.1:8080` en tu PC — el servidor lo ve como local y los pasos de arriba funcionan tal cual. ## 3. Instalarlo como app - **Android (Chrome, Edge, Samsung):** menú ⋮ → *Instalar app*. - **iPhone / iPad (Safari):** Compartir → *Agregar a pantalla de inicio*. ## Sesiones y acceso - Desde la propia PC se entra sin nada, como siempre. Todo lo demás — túnel, red local, dominio — necesita un dispositivo emparejado. - Otro sitio web nunca puede usar tu Lampson, ni siquiera desde un navegador de la PC: una petición desde otra origin se rechaza (eso cubre a una página que intente llegar a `127.0.0.1:8080`, terminal incluida). - Usa un túnel HTTP (Synsema, cloudflared) hacia el hub. Un reenvío TCP crudo (`ssh -R`, `ngrok tcp`) no deja rastro de dónde viene el visitante, así que Lampson no podría distinguirlo de la PC. - La sesión se renueva sola mientras la uses: vence tras **30 días sin usarla**, y la passkey se pide igual cada **90 días**. - En **dispositivos** ves los emparejados, les cambias el nombre, cierras la sesión o quitas uno; quitarlo lo deja afuera al instante. - Si cambia la dirección (otro túnel rápido, otro dominio), hay que emparejar de nuevo: la passkey queda atada a la dirección.