Cuando una máquina remota se queda en «Atención»: lo nuevo de Herdr para recuperar SSH

Si usas Herdr con máquinas SSH guardadas, conoces la escena: el portátil vuelve de la suspensión, la VPN ha caducado o el servidor pide otra vez el segundo factor, y la máquina aparece en la barra lateral con Atención. Hasta ahora la salida era ejecutar a mano herdr --remote workbox, responder a lo que pidiera SSH y reiniciar el cliente para que lo volviera a intentar.

Eso cambia con dos comandos que entraron en la rama principal de Herdr el 22 de septiembre: herdr machine status y herdr machine reconnect.

Actualización (19 de octubre de 2026): los dos comandos salieron en la v0.9.2, del 29 de septiembre, y están en todas las versiones posteriores. La documentación estable ya los recoge.

Qué pasa por debajo

Las conexiones de las máquinas guardadas van en segundo plano, y por diseño no pueden preguntarte nada: ni una contraseña, ni la frase de una clave, ni un código de MFA. Cuando SSH necesita algo de eso, Herdr marca la máquina y espera a que lo resuelvas tú.

La novedad es cómo lo resuelves. En Linux y macOS, con remote.manage_ssh_config activado (viene así por defecto), Herdr mantiene una conexión de OpenSSH compartida y ya aprobada. La usan machine add, la barra lateral y los comandos de la CLI que apuntan a una máquina guardada con --machine. Si te autenticas una vez en esa conexión, todo lo demás se engancha a ella.

Diagnosticar: machine status

herdr machine status
herdr machine status workbox --json

Hace una comprobación nueva de SSH y del Herdr remoto, sin pedirte nada. Sirve para saber si el problema está en la red, en la autenticación o en el servidor de Herdr del otro lado.

Un detalle que conviene tener claro: que salga accesible (reachable en la salida JSON) quiere decir que el servidor remoto responde ahora mismo a esta comprobación. No dice nada de si cada TUI que tengas abierta está conectada en este momento. Con --json lo puedes meter en un script que vigile tus máquinas.

Reparar: machine reconnect

herdr machine reconnect workbox

Esto sí es interactivo, así que ejecútalo en una terminal normal. Abre la autenticación SSH de siempre (contraseña, frase de la clave, MFA o lo que te pida el servidor) y, cuando termina, verifica la máquina guardada. Los clientes de Herdr que tengas abiertos vuelven a comprobar las conexiones fallidas cada 30 segundos como mucho, así que en poco tiempo la máquina pasa sola a estar en línea. No hace falta reiniciar nada.

Lo que no hace es instalar ni actualizar Herdr en el remoto. Para eso sigue siendo herdr --remote workbox.

Las marcas nuevas de la barra lateral

«Atención» ya no es un cajón de sastre:

• ! auth: falló la autenticación. Es el caso de machine reconnect.
• ! error: otro problema, como una clave de host desconocida o un servidor incompatible.

Si pulsas la marca verás el último error y el comando de la CLI que toca ejecutar. Con la barra lateral plegada, las dos se quedan en un !. En ningún caso aparece una ventana pidiendo credenciales.

Límites que conviene conocer

La conexión compartida usa ControlPersist 600, que son diez minutos sin actividad. Eso no es lo que dura tu MFA: una conexión activa puede seguir abierta mucho más, y la política de tu empresa, el servidor SSH o la red pueden cortarla antes.

En Windows como cliente local, esta recuperación todavía no está disponible. Y si desactivas manage_ssh_config, la autenticación queda en tus manos: hacer ssh workbox por tu cuenta no le sirve a Herdr, salvo que esa conexión use el mismo ControlPath compartido.

Las claves de host no cambian de comportamiento. Una clave desconocida o que ha cambiado sigue dejando la máquina en Atención hasta que la apruebes con herdr --remote workbox.

Para una clave con frase de paso, el consejo de siempre sigue valiendo: cárgala con ssh-add antes de arrancar Herdr y te ahorrarás la mayoría de estos avisos.

Todo el detalle está en Conectar máquinas y de la referencia de la CLI. Si todavía no tienes montado el flujo de trabajo con un servidor remoto, empieza por Claude Code y Herdr.