Companion

Empareja la app de iOS de MadoHub con tu Mac y refleja tu lienzo a través de la red local.

Companion refleja tu lienzo de MadoHub en la app de iOS a través de tu Wi-Fi local. Levántate del escritorio y vigila tus agentes desde el teléfono; envía una pulsación rápida o lanza un Flow sin volver al teclado.

Es un espejo por LAN, no una retransmisión por la nube. Nada de tu lienzo, tus agentes o la salida de tu terminal pasa por un servidor de MadoHub. La Mac corre un pequeño servidor en tu red local y tu teléfono se conecta a él directamente, manteniéndose sincronizado mientras ambos estén en la misma Wi-Fi.

Qué puedes hacer con él

Ver tu lienzo desde el teléfono — cada marco, tile, estado de agente, línea de actividad y una cola reciente de la salida del terminal, en modo solo lectura.
Abrir un tile para leer el detalle completo de su terminal — el teléfono muestra los mismos estados de tile que usa el escritorio (inactivo, trabajando, esperando, detenido, completado, fallido, salido).
Enviar pulsaciones de teclas a un tile — texto libre, además de escape, ctrl-c y enter como teclas especiales, entregadas igual que si las escribieras localmente.
Crear un terminal o marco desde el teléfono — lanza un terminal nuevo en el centro del viewport del escritorio, o abre un marco de espacio de trabajo por ruta.
Ejecutar un Flow de forma remota — instancia un Flow desde el teléfono con un prompt de tarea, y el escritorio lo lanza.
Restablecer el token de emparejamiento — invalida inmediatamente todos los dispositivos emparejados desde Configuración si pierdes un teléfono o quieres empezar de cero.

Cómo usarlo

Abre Configuración → General en la Mac y activa Companion.
El panel de configuración muestra la IP local y el puerto de tu Mac (por ejemplo 192.168.1.23:9280), un token de emparejamiento y un enlace madohub://companion?… que puedes copiar al teléfono.
Abre el enlace en tu teléfono (o ingresa la dirección y el token manualmente en la app de iOS).
El teléfono se empareja y empieza a reflejar el lienzo. Configuración muestra cuántos dispositivos están conectados actualmente.
Desde el teléfono, toca un tile para leer su detalle, envía entrada a un tile, o usa el menú para crear un terminal, abrir un marco o ejecutar un Flow.

Para desemparejar todo, haz clic en reset token en Configuración. Cada dispositivo emparejado se invalida de inmediato; si el servidor está corriendo, se reinicia bajo el nuevo token.

Casos de uso comunes

"Vigilar un agente de larga duración desde el sofá." — abre el teléfono, mira el estado del tile y la salida reciente, envía ctrl-c si se descarrila.
"Lanzar un Flow de peer review sin volver al escritorio." — desde el teléfono, ejecuta el Flow de Peer review con un prompt de tarea.
"Aprobar un mensaje de permiso desde el otro lado de la habitación." — toca el tile, envía y o enter para desbloquear al agente.

Consejos y buenas prácticas

Ambos dispositivos deben estar en la misma Wi-Fi. Companion no funciona por internet ni entre subredes.
El espejo del lienzo es de solo lectura — puedes ver tiles y enviar entrada, pero no arrastrar tiles ni recablear conexiones desde el teléfono.
Restablece el token si pierdes un teléfono emparejado o cambias de red. El nuevo token invalida todos los emparejamientos previos de inmediato.
El servidor prueba primero el puerto 9280 y sube hasta 9299 si está ocupado, así que el puerto exacto puede variar entre máquinas — copia el enlace desde Configuración en lugar de adivinarlo.

Seguridad y privacidad

Solo LAN, sin retransmisión por la nube. Tu lienzo, tus agentes y la salida del terminal se quedan en tu red local; nada pasa por un servidor de MadoHub.
El emparejamiento usa un token + challenge-response, no un bearer token en cada petición. El token en sí nunca cruza la red; solo una respuesta salada a un challenge nuevo por conexión, de modo que una respuesta capturada no puede reproducirse contra una conexión posterior.
Nadie puede escribir sin el token. Un observador pasivo en la misma Wi-Fi puede leer el tráfico espejado (todavía no hay TLS), pero no puede abrir una sesión autenticada propia ni inyectar entrada sin el token.
El servidor se protege contra una LAN hostil — como máximo 64 conexiones concurrentes, y un cliente autenticado que se quede en silencio durante 60 segundos se desconecta para que no pueda acaparar un slot de conexión indefinidamente.

Funciones relacionadas

Flows — ejecuta un Flow de forma remota desde el teléfono.
Configuración — donde activas Companion y restableces el token.
Colaboración en equipo — para monitorear miembros del equipo en lugar de tu propio lienzo.

Limitaciones

Companion requiere que ambos dispositivos estén en la misma Wi-Fi local. El uso fuera de la LAN (por internet) todavía no es compatible.
No hay TLS en la conexión. Un observador pasivo en la misma LAN puede leer el tráfico espejado; los ataques activos de man-in-the-middle todavía no están cubiertos.
El espejo del lienzo es de solo lectura — no puedes arrastrar tiles ni recablear conexiones desde el teléfono.
Companion actualmente requiere una Mac como host. Todavía no hay soporte para host en Windows.