local-web-tunnel

Installation
SKILL.md

Artefacto web local → túnel público persistente (cloudflared + launchd)

When to Use

el operador necesita ver un artefacto web local (dashboard HTML, demo, landing) desde el móvil — p.ej. el navegador interno de Orca, donde no puede tocar ni refrescar HTML — o compartir un demo por Discord/WhatsApp. Patrón de casa: HTTP local + túnel trycloudflare (sin login, gratis) + agente launchd para que sobreviva a la sesión de Hermes y a reinicios del Mac (vuelve al hacer login).

Pasos

  1. Comprobar which cloudflared (brew: /opt/homebrew/bin/cloudflared) y elegir un puerto libre: lsof -i :8085 -sTCP:LISTEN.
  2. Servir el artefacto SOLO en localhost: python3 -m http.server PORT --bind 127.0.0.1 desde su directorio. El puerto no se expone a la LAN; lo único público es el túnel.
  3. Túnel: cloudflared tunnel --url http://127.0.0.1:PORT — la URL trycloudflare aparece en stdout/log en ~5-10s. Extraerla con grep -o "https://[a-z0-9-]*\.trycloudflare\.com" <log>.
  4. Persistencia: agente launchd con KeepAlive + wrapper idempotente (plantillas en templates/). Arrancar con launchctl load -w ~/Library/LaunchAgents/<label>.plist; parar con launchctl unload (matar cloudflared/http.server a mano si quedan).
  5. Verificar SIEMPRE con curl: 200 en http://127.0.0.1:PORT/index.html y 200 en la URL pública. Confirmar con launchctl list | grep <label> (PID vivo).

Acceso privado desde el móvil: tailscale serve (preferido si hay tailnet)

trycloudflare publica al mundo entero y la URL cambia en cada relanzamiento. Si el artefacto es algo con poder real (un harness de agentes que ejecuta bash, un panel de administración), lo correcto es el tailnet: WireGuard cifrado, URL fija, cero exposición a Internet.

Installs
1
First Seen
13 days ago