Sesiones y flujo de trabajo

Tactic Remote usa sesiones tmux para mantener tus procesos de Claude Code activos entre desconexiones. Esta página explica cómo funcionan las sesiones y el flujo de trabajo diario.

Cómo funcionan las sesiones

Cada sesión corresponde a:

• Un directorio de trabajo (tu carpeta de proyecto).
• Una sesión tmux en tu Mac que ejecuta Claude Code.
• Un flujo de salida del terminal que se muestra en tu iPhone.

Las sesiones persisten incluso si:

• La app de iPhone se cierra o pasa a segundo plano.
• La red se desconecta temporalmente.
• El Mac se suspende y se despierta.

Cuando reconectas, la app restaura la sesión y su salida de terminal.

Crear una sesión

1. Toca el selector de sesiones (arriba a la izquierda en la app).
2. Toca Nueva sesión.
3. Navega por el sistema de archivos de tu Mac y selecciona un directorio de proyecto.
4. Nombra la sesión (ej. mi-api, trabajo-frontend).
5. Toca Crear.

Puedes tener múltiples sesiones para diferentes proyectos y cambiar entre ellas.

Iniciar Claude Code

Toca el botón Iniciar para lanzar Claude Code en la sesión actual.

La app tiene protección contra inicio duplicado: si Claude Code ya está en ejecución en la sesión, tocar Iniciar no hace nada. Esto previene lanzamientos dobles accidentales.

Verifica antes de iniciar: Mira el indicador de estado. Verde "En ejecución" significa que Claude ya está activo — no necesitas tocar Iniciar.

Enviar prompts

Escribe en el campo de entrada del chat y envía. Tu prompt viaja por el WebSocket hasta tu Mac, que lo pasa al proceso de Claude Code. La salida se transmite de vuelta en tiempo real.

Acciones rápidas

La app proporciona botones de acceso directo para entradas de terminal comunes:

• Enter — enviar entrada
• Escape — cancelar operación actual
• Tab — autocompletar
• Teclas de flecha — navegar
• Ctrl+C — interrumpir

Reconexión

Cuando la app pierde la conexión (cambio de red, paso a segundo plano, etc.):

1. Intenta reconectar automáticamente con backoff exponencial.
2. Al reconectar, se reacopla a tu sesión tmux existente.
3. La salida del terminal acumulada durante la desconexión se restaura.

No necesitas hacer nada — solo reabre la app.

Si la vista parece desactualizada: Abre el selector de sesiones y vuelve a seleccionar tu sesión. Esto fuerza un refresco.

Notificaciones

Para tareas de larga duración, no necesitas mantener la app abierta:

1. Claude Code soporta hooks que se disparan cuando las tareas se completan.
2. El servidor retransmite estos eventos como notificaciones push a tu iPhone.
3. Cuando llega la notificación, abre la app para revisar el resultado.

Mantén activados los permisos de notificación de iOS para Tactic Remote.

Finalizar una sesión

• Detener Claude: Toca el botón Detener para terminar el proceso de Claude Code. La sesión permanece disponible para reiniciar después.
• Eliminar sesión: Desde el selector de sesiones, desliza para eliminar. Esto elimina la sesión tmux de tu Mac.