tmux

Tmux (Terminal Multiplexer) permite que las sesiones de terminal se ejecuten de forma independiente a la ventana o conexión SSH que las inició. Para los usuarios de Spck CLI esto significa que puedes mantener las sesiones activas durante las reconexiones, compartir una sesión de agente en ejecución entre el escritorio y el móvil, y ejecutar la CLI de forma persistente en un servidor remoto incluso después de que tu conexión SSH se interrumpa.

Instalación

brew install tmux

sudo apt-get install tmux

sudo dnf install tmux

sudo pacman -S tmux

wsl --install

sudo apt-get install tmux

Caso de uso 1: Compartir sesiones de agente entre escritorio y móvil

El flujo de trabajo más potente de tmux con Spck CLI es iniciar un agente de codificación IA en tu escritorio y retomarlo sin problemas desde tu móvil — o al revés. Ambos ven exactamente el mismo estado del terminal, incluyendo el historial de desplazamiento completo.

💡 Consejo: Si usas un agente compatible con ACP (Claude Code, Codex, Gemini CLI), puedes controlarlo desde el Chat de IA de Spck Editor sin necesidad de compartir un terminal. Consulta Agentes de IA en el móvil (ACP) — tmux sigue siendo útil para agentes basados en shell o cuando quieras ver la salida cruda del agente en directo entre dispositivos.

Iniciar una sesión en el escritorio

Crea una sesión tmux con nombre:

tmux new -s code

Inicia tu agente IA dentro de la sesión:

claude

El agente se ejecuta dentro de tmux. Desconéctate en cualquier momento presionando Ctrl+B y luego D — la sesión y todo lo que se ejecuta dentro de ella continúa en segundo plano.

Conectarse desde el móvil

1. Abre Spck Editor y conéctate a tu servidor CLI
2. Abre un terminal desde el panel de terminal de Spck Editor
3. Conéctate a la sesión tmux en ejecución:

tmux attach -t code

Verás exactamente el mismo terminal que en tu escritorio — incluyendo el agente en ejecución, su salida y el historial de desplazamiento completo. Varios clientes pueden conectarse simultáneamente y ver la salida en tiempo real.

Volver al escritorio

Reconéctate desde cualquier terminal en cualquier momento:

tmux attach -t code

Caso de uso 2: CLI persistente en un servidor remoto

Si ejecutas Spck CLI en un servidor remoto a través de SSH, la CLI se detiene en el momento en que la sesión SSH termina — ya sea porque cierras el portátil, pierdes la conexión Wi-Fi o la conexión se agota. Tmux mantiene el proceso activo en el servidor independientemente del estado de tu conexión.

Configuración en el servidor remoto

Conéctate por SSH a tu servidor e inicia una sesión tmux con nombre antes de lanzar la CLI:

ssh [email protected]
tmux new -s spck
spck

La CLI ahora se ejecuta dentro de tmux en el servidor. Cierra la conexión SSH — o piérdela por completo — y la CLI sigue ejecutándose.

Reconectarse después de desconectarse

ssh [email protected]
tmux attach -t spck

La CLI reanuda exactamente donde lo dejó. Los clientes móviles pueden reconectarse normalmente a través del servidor relay.

Listar sesiones en ejecución

tmux ls

Alternativa: Servicio de Linux

Para una configuración totalmente automatizada que inicie la CLI al arrancar sin ninguna gestión manual de tmux, ejecuta Spck CLI como un servicio systemd.

Crear el archivo de servicio

sudo nano /etc/systemd/system/spck-cli.service

[Unit]
Description=Spck CLI Server
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/path/to/your/project
ExecStart=/usr/bin/npx spck
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Reemplaza your-username y /path/to/your/project con tus valores reales. Si instalaste spck globalmente (npm install -g spck), reemplaza ExecStart con la salida de which spck.

Habilitar e iniciar

sudo systemctl daemon-reload
sudo systemctl enable spck-cli
sudo systemctl start spck-cli

Comprobar estado y registros

# Ver estado
sudo systemctl status spck-cli

# Seguir registros en tiempo real
journalctl -u spck-cli -f

El servicio se inicia automáticamente en cada reinicio y se reinicia solo si el proceso falla.

Comandos esenciales de Tmux