Las sesiones de Claude Code iniciadas en ventanas de terminal sueltas tienen un problema: cuando quieres revisar el progreso desde el móvil, la sesión está en marcha pero no en un sitio al que puedas conectarte.

Herdr (y tmux/zellij) cambian ese flujo: las sesiones de agentes se inician en paneles de terminal persistentes y Happier abre esos mismos paneles desde el móvil. Happier es una app de código abierto que te permite ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos.

En resumen

1. Instala Herdr 0.9.2 o posterior (o tmux/zellij en macOS/Linux)
2. En Happier: Configuración (Settings) → Sesión (Session) → Terminal para nuevas sesiones (Terminal host for new sessions) → Herdr (o tmux/zellij)
3. Ejecuta happier claude o happier codex en un panel de Herdr (o deja que Happier abra uno)
4. Desde el móvil: la sesión aparece en Herdr, conectada y en directo
5. Más tarde: happier attach <session-id> te lleva al mismo panel

El problema

Iniciar agentes en una ventana de terminal normal significa que:

• la sesión se ejecuta pero no es accesible desde otra terminal
• no hay persistencia si cierras la ventana
• no es fácil ver qué está haciendo el agente desde otro dispositivo

El objetivo son sesiones de agente que:

• se inicien en un multiplexor de terminal persistente
• sean accesibles desde el móvil (no solo por SSH adivinando cuál es la sesión)
• sobrevivan al reposo o a la desconexión del portátil

Enfoques habituales y sus contrapartidas

• Ventana de terminal normal: funciona hasta que la cierras o el portátil entra en reposo. No hay forma de volver a conectarse.
• tmux a mano: mejor, pero tienes que acordarte de arrancar tmux primero, poner nombre a la sesión y averiguar desde el móvil qué sesión de tmux es cuál.
• SSH y buscar el panel correcto: funciona pero es tedioso. Acabas adivinando números de ventana.

Happier con Herdr (o tmux/zellij) lo resuelve así:

• inicia automáticamente las sesiones en el host de terminal elegido
• las muestra por nombre de sesión en el móvil
• te permite conectarte exactamente al mismo panel

Si Happier es nuevo para ti

Happier es una app complementaria de código abierto (móvil/web/escritorio) para agentes de programación con IA como Claude Code, Codex y OpenCode.

El flujo aquí: Happier inicia Claude Code o Codex dentro de Herdr (o tmux/zellij) y puedes acceder a la misma sesión desde el móvil con la interfaz de terminal del agente intacta.

Para empezar:

• Cómo usar Happier desde el móvil
• GitHub: https://github.com/happier-dev/happier
• Instalación: https://github.com/happier-dev/happier#how-it-works
• Discord: https://discord.gg/W6Pb8KuHfg

Requisitos previos

Para Herdr

• Herdr 0.9.2 o posterior (se necesita una versión estable)
• Disponible en macOS y Linux
• No compatible con Windows nativo (usa tmux en WSL)

Comprueba tu versión de Herdr:

herdr --version

Si tienes una versión antigua o una compilación de desarrollo, actualiza a una versión estable 0.9.2 o posterior.

Para tmux o zellij

• tmux o zellij instalado en macOS o Linux
• Sin restricciones de versión mínima para tmux/zellij
• También funcionan en WSL en Windows

Happier CLI

Instala la CLI de Happier en la máquina donde quieras ejecutar los agentes:

• Guía de instalación de la CLI (en inglés)

Paso a paso: configura el host de terminal para nuevas sesiones

1) Abre la configuración de Happier

Desde la app de Happier (móvil, web o escritorio):

1. Ve a Configuración (Settings)
2. Selecciona Sesión (Session)
3. Busca Terminal para nuevas sesiones (Terminal host for new sessions)

2) Elige tu host de terminal

Selecciona una opción:

• Sin terminal (No terminal host): las sesiones se inician sin interfaz (por defecto)
• tmux: usa tmux como host de terminal
• zellij: usa zellij como host de terminal
• Herdr: usa Herdr como host de terminal (requiere CLI 0.2.16 o posterior)

Para esta guía: elige Herdr (o tmux si lo prefieres).

Por qué importa:

• Con Sin terminal (No terminal host), las sesiones de Happier se ejecutan en segundo plano hasta que te conectes de forma explícita
• Con un host de terminal, las sesiones compatibles aparecen al instante en esa terminal
• La sesión sigue siendo accesible tanto desde la terminal como desde la app de Happier

3) El ajuste se aplica por máquina

Happier guarda esta preferencia en la cuenta, pero la aplica por máquina.

Si tienes varias máquinas:

• cada una puede usar un host de terminal distinto
• o sobrescribir en local el valor por defecto de la cuenta

4) Comprueba que el ajuste se ha guardado

La interfaz debería mostrar el host elegido (por ejemplo, Herdr).

Inicia una sesión de Claude Code en Herdr

Opción A: inicia desde dentro de un panel de Herdr

Si ya estás en un panel de Herdr:

happier claude

Happier reutiliza el panel actual de Herdr para la interfaz de terminal de Claude Code.

Opción B: deja que Happier cree un panel nuevo

Si ejecutas happier claude fuera de Herdr, Happier crea un panel nuevo de Herdr e inicia Claude Code en él.

Qué verás

La interfaz de terminal (TUI) de Claude Code aparece en el panel de Herdr:

• prompts y respuestas en la terminal
• solicitudes de aprobación en línea
• la sesión está en directo y conectada

Inicia una sesión de Codex en Herdr

El flujo es el mismo para Codex:

happier codex

Según la documentación de Codex (en inglés):

• Codex usa su ruta nativa de App Server en macOS y Linux
• cuando se elige Herdr (u otro host de terminal), Happier inicia la TUI de Codex en ese host
• sin host de terminal, Codex se ejecuta respaldado por el servidor y sin interfaz hasta que te conectes

Ver y conectarte desde el móvil

Desde la app de Happier

1. Abre la app de Happier en el móvil
2. La lista de sesiones muestra la sesión de Claude Code o Codex en marcha
3. Toca la sesión para abrirla

Qué pasa:

• la app muestra la transcripción y los controles de la sesión
• si la sesión está en Herdr, puedes conectarte para ver su interfaz de terminal
• las solicitudes de aprobación aparecen en la app y en la terminal

Conéctate al panel de Herdr

Desde una terminal (local o por SSH):

happier attach <session-id>

Esto te lleva al mismo panel de Herdr donde se ejecuta Claude Code o Codex.

También puedes usar:

happier herdr

Esto abre Herdr desde la terminal y puedes ir al panel de la sesión con los controles de Herdr.

Por qué funciona

Herdr (y tmux/zellij) mantienen vivas las sesiones de terminal aunque te desconectes.

Happier lo aprovecha así:

1. inicia las sesiones de agente en paneles de Herdr con nombre
2. registra qué sesión está en qué panel
3. muestra la sesión por nombre en el móvil
4. permite que happier attach salte directamente a ese panel

El resultado: inicias una sesión de agente una vez y puedes acceder a ella desde:

• la terminal original
• una terminal nueva con happier attach
• el móvil mediante la app de Happier
• la navegación nativa de paneles de Herdr

Solución de problemas

Síntoma: Happier dice que hace falta configurar el host de terminal

Causa probable:

• Herdr no está instalado o la versión es anterior a 0.9.2
• el servidor de Herdr no está en marcha

Solución:

1. Comprueba que Herdr está instalado: herdr --version
2. Asegúrate de que la versión es 0.9.2 o posterior
3. Si Herdr no está en marcha, inícialo: herdr
4. Vuelve a intentar iniciar la sesión

Síntoma: las sesiones se inician pero no en Herdr

Causa probable:

• el ajuste del host de terminal se cambió después de iniciar la sesión
• usas una CLI de Happier antigua (anterior a 0.2.16)

Solución:

1. Comprueba la versión de la CLI: happier --version
2. Actualiza a la CLI 0.2.16 o posterior si hace falta
3. Confirma el ajuste en Configuración (Settings) → Sesión (Session) → Terminal para nuevas sesiones (Terminal host for new sessions)
4. Detén la sesión e inicia una nueva

Síntoma: no puedo conectarme al panel de la sesión

Causa probable:

• el panel de Herdr de la sesión se cerró a mano
• el servidor de Herdr se reinició y el panel no se restauró

Solución:

1. Comprueba si la sesión sigue en marcha: happier sessions
2. Si la sesión está viva pero el panel ha desaparecido, el proceso del agente continúa
3. Puedes seguir controlándola desde la app de Happier (transcripción/aprobaciones)
4. Conectarte crea una vista nueva, no necesita el panel original

Síntoma: tengo varias sesiones de Claude y no sé qué panel es cuál

Causa probable:

• iniciar sesiones sin revisar antes la lista de sesiones

Solución:

1. Usa happier sessions para listar todas las sesiones activas con sus ID
2. Usa happier attach <session-id> para saltar al panel de una sesión concreta
3. O abre la app de Happier y toca la sesión para ver sus detalles

Preguntas frecuentes

¿Funciona también con tmux y zellij?

Sí. Se aplica el mismo flujo:

• pon Terminal para nuevas sesiones (Terminal host for new sessions) en tmux o zellij
• ejecuta happier claude o happier codex
• las sesiones aparecen en ventanas de tmux o paneles de zellij
• happier attach funciona igual

¿Tengo que usar Herdr?

No. Puedes usar:

• Sin terminal (No terminal host) (sin interfaz hasta que te conectes)
• tmux
• zellij
• Herdr

Elige el que encaje con tu forma de trabajar.

¿Puedo cambiar de host de terminal?

Sí. Cambia el ajuste en Configuración (Settings) → Sesión (Session) → Terminal para nuevas sesiones (Terminal host for new sessions).

El ajuste se aplica a las sesiones nuevas. Las existentes siguen usando su host original.

¿Qué pasa si el portátil entra en reposo?

La sesión y su panel de Herdr se mantienen mientras la máquina sea accesible.

Cuando vuelves a conectarte:

• Herdr mantiene vivo el panel
• el proceso del agente continúa
• happier attach funciona como antes

Si la máquina se queda totalmente desconectada, el relay de Happier pierde el contacto hasta que la máquina vuelva a conectarse.

¿El host de terminal afecta al rendimiento?

No. El host de terminal es donde aparece la interfaz de terminal del agente. El proceso del agente y su rendimiento no se ven afectados.

Guías relacionadas

• Cómo usar Happier desde el móvil
• Happier vs. Claude Code Remote Control
• Mantén Claude Code, Codex y OpenCode en marcha cuando el portátil entra en reposo (cortes de Wi-Fi, cerrar la tapa, reanudar)
• Cómo supervisar Claude Code desde el móvil
• Cómo arreglar el parpadeo de Claude Code en la terminal