Tactic Remote

Diagnóstico de conexión

Guía paso a paso para diagnosticar problemas de conexión y latencia.

Cuando las cosas no funcionan, los reintentos aleatorios son una pérdida de tiempo. Usa esta secuencia para aislar el problema.

Paso 1: Clasificar el síntoma

SíntomaCausa probable
No conecta en absolutoRed o configuración de endpoint incorrecta
Conecta pero el terminal va lentoLatencia de red o Mac bajo carga
Conecta pero la salida está desactualizadaProblema de estado de sesión
Faltan notificacionesEntrega de hooks o permisos iOS

Paso 2: Verificar el servidor

En tu Mac, verifica que el servidor está escuchando:

lsof -nP -iTCP:8765 -sTCP:LISTEN

Deberías ver un proceso node. Si no aparece nada, el servidor no está en ejecución.

Si usas Cloudflare Tunnel, también verifica:

ps aux | grep cloudflared

Paso 3: Probar la accesibilidad de red

Desde otro dispositivo en la misma red (o desde tu propio Mac):

# Probar si el puerto es accesible
nc -zv <mac-ip> 8765
 
# Si usas un túnel
curl -I https://tu-url-tunel.trycloudflare.com

Si el puerto no es accesible, verifica:

  • Configuración del firewall del Mac
  • La interfaz de red correcta (en0 para WiFi, en1 para Ethernet)
  • Si los dispositivos están en la misma subred

Paso 4: Verificar el rendimiento del Mac

Si la conexión funciona pero se siente lenta:

# CPU y memoria
top -l 1 -s 0 | head -10
 
# Verificar sesiones tmux (¿hay muchas?)
tmux list-sessions

Un Mac bajo carga pesada retrasará la salida del terminal, haciendo que parezca un problema de red.

Paso 5: Refrescar la sesión

Si la salida parece desactualizada o el terminal está en blanco:

  1. Abre el selector de sesiones en la app de iPhone.
  2. Vuelve a seleccionar la sesión.
  3. Esto reconecta a la sesión tmux y refresca la salida.

Si la sesión ya no existe (fue eliminada o el servidor se reinició), crea una nueva.

Paso 6: Verificar la entrega de notificaciones

Si las notificaciones push no funcionan:

  1. Permisos iOS: Ajustes > Tactic Remote > Notificaciones > Permitir.
  2. Eventos hook: Claude Code dispara eventos hook que el servidor retransmite. Asegúrate de que el servidor los está recibiendo:
    curl -X POST http://localhost:8765/hook -d '{"type":"test"}'
  3. Versión de la app: Asegúrate de que tanto la app de Mac como la de iOS estén en la última versión.

Cuándo abrir un ticket de soporte

Si nada de lo anterior resuelve el problema, contacta con soporte con:

  • Versión de la app (Mac e iOS)
  • Modo de conexión (Local o Túnel)
  • Pasos que intentaste
  • Capturas de pantalla o mensajes de error (redacta cualquier API key)

En esta página