Wendov1.0 · iOS y Android
Español

Aprende

tmux para agentes de código: lo mínimo para que sigan vivos

· 4 min de lectura

Si lanzas un agente directamente en una shell SSH, vive lo que viva esa conexión. Con tmux, el agente corre en el servidor aunque te desconectes, y vuelves a entrar cuando quieras desde el portátil o desde el móvil. No hace falta saber tmux a fondo: con una docena de comandos te apañas.

Este artículo es el complemento de Mosh o SSH en el móvil, y encaja en la guía Cómo usar Claude Code desde el móvil.

Una sesión que sobrevive

El comando que más vas a usar:

tmux new-session -A -s agentes

La opción -A hace que, si ya existe una sesión con ese nombre, entre en ella; si no, la crea. Así puedes ejecutar siempre lo mismo. Dentro, lanza tu agente como harías en una shell normal:

cd ~/code/mi-app
claude

Para salir sin matar nada, desacopla con Ctrl-b y luego d. El agente sigue corriendo. Para volver:

tmux attach -t agentes

Y para ver qué sesiones hay:

tmux ls

Si cierras la terminal, se corta el wifi o se muere el SSH, da igual: la sesión sigue en el servidor. Esa es toda la gracia.

Ventanas: un agente por ventana

Una sesión tiene ventanas, como pestañas. La situación típica: un refactor largo corriendo en la ventana 2 mientras los tests se ejecutan en la 3, y tú tocando algo en la 1.

Dentro de tmux, todos los atajos empiezan por Ctrl-b:

  • c crea una ventana nueva.
  • , renombra la ventana actual.
  • n y p pasan a la siguiente y a la anterior.
  • 0–9 saltan a una ventana por número.
  • w abre una lista para elegir.

También puedes crear y nombrar desde fuera, o desde un script:

tmux new-window -n claude -c ~/code/mi-app
tmux new-window -n codex -c ~/code/mi-app
tmux rename-window -t agentes:2 refactor

Ponerle nombre a cada ventana importa más de lo que parece: desde el móvil vas a leer «claude», «codex» o «tests» en una lista pequeña, y «bash» cuatro veces no ayuda.

Paneles

Si quieres ver dos cosas a la vez dentro de la misma ventana, divídela:

  • Ctrl-b % parte la ventana en dos columnas.
  • Ctrl-b " la parte en dos filas.
  • Ctrl-b o salta al siguiente panel.
  • Ctrl-b x cierra el panel actual (pide confirmación).

En una pantalla de móvil, normalmente es mejor una ventana por cosa que paneles. En el portátil, paneles.

Un ~/.tmux.conf pequeño

Dos ajustes cambian mucho la experiencia: ratón y más historial. El historial por defecto es de unas 2000 líneas, y un agente las gasta en nada.

set -g mouse on
set -g history-limit 50000
set -g allow-rename off

Con mouse on puedes desplazarte con el dedo o la rueda y seleccionar paneles tocándolos. allow-rename off evita que el programa en ejecución cambie el nombre de tu ventana. Recarga con:

tmux source-file ~/.tmux.conf

Para leer lo que quedó atrás sin ratón, entra en modo copia con Ctrl-b [ y sube con las flechas o PgUp; sal con q. Esto es lo que Mosh no te da y tmux sí.

Varios agentes a la vez: git worktrees

Dos agentes editando el mismo directorio se pisan. La solución limpia es un worktree por agente: cada uno trabaja en su propia rama y su propia carpeta, compartiendo el mismo repositorio.

cd ~/code/mi-app
git worktree add ../mi-app-auth -b feature/auth
git worktree add ../mi-app-informes -b feature/informes
git worktree list

Y una ventana de tmux para cada uno:

tmux new-window -n auth -c ~/code/mi-app-auth
tmux new-window -n informes -c ~/code/mi-app-informes

Cuando termines una rama y la hayas integrado:

git worktree remove ../mi-app-auth

Cómo lo usa Wendo

Wendo es un cliente SSH para iOS y Android pensado para seguir agentes de código, y tmux es la pieza central. La integración con tmux es una función de Wendo Pro.

  • Al conectar, entrar en: elige tmux y, si quieres, un nombre de sesión. Wendo ejecuta tmux new-session -A -s wendo (o el nombre que pongas), así que cada vez que abres la conexión estás de vuelta en tu sesión.
  • Máquinas muestra, para cada ordenador, sus sesiones, ventanas y paneles. Tocas uno y se abre justo ahí.
  • Con tmux, la hoja de espacios de trabajo te deja cambiar de ventana, renombrar, cerrar paneles o ventanas y crear una sesión. También puedes lanzar un agente (Claude Code, Codex, OpenCode o Gemini CLI) en una ventana nueva, o crear un worktree de git en una rama nueva y abrirlo en su propia ventana, que es lo que acabas de hacer a mano arriba.
  • Los avisos de la bandeja te llevan al panel exacto si Claude corre dentro de un multiplexor. Cómo se instala el hook está en alertas y aprobaciones.

En los ajustes del terminal hay opciones como aplicar las opciones globales de tmux (títulos, ratón y barra de estado). Todo está en la documentación de tmux; y si tu conexión es inestable, la documentación de sesiones explica Mosh y ET.

Alternativas: zellij y herdr

Si prefieres otro multiplexor, Wendo también funciona con zellij (zellij attach -c wendo) y con herdr (herdr o herdr --session <nombre>). Tienen que estar instalados en el ordenador. La idea es la misma: el agente vive en el servidor y tú entras y sales.