Mejores Clientes Herdr: Web UI, Apps Móviles y de Escritorio (2026)

Herdr no tiene web UI oficial, ni app móvil oficial, ni app de escritorio oficial. Eso no es una carencia, es el diseño. Herdr es un runtime: un servidor en segundo plano posee PTYs reales, agentes como Claude Code, Codex, OpenCode, Gemini CLI y Pi viven dentro de ellos, y cada interfaz es solo un cliente que se conecta. Así que la pregunta es qué clientes Herdr usar para qué trabajo. Esta guía compara todo el ecosistema de clientes lado a lado: la TUI integrada, cinco opciones de herdr web ui comunitarias, las apps móviles y las apps de escritorio. Obtienes una tabla de decisión, la postura de seguridad de cada cliente, las trampas de versiones, y un montaje VPS endurecido que puedes correr esta noche. Para cómo funciona el runtime en sí, lee primero nuestra reseña de Herdr. Para qué correr dentro de los paneles, mira las mejores herramientas y agentes de codificación IA.

¿Qué cuenta como cliente Herdr? (runtime vs. interfaz, en 90 segundos)

Herdr es un servidor de sesiones en segundo plano más uno o más clientes de terminal. El servidor posee PTYs reales; tus agentes de codificación corren dentro de esos PTYs. Cierra el cliente, pierde SSH, suspende el portátil. Los agentes siguen corriendo. Desconecta con ctrl+b q, reconecta con herdr. Esa es la parte que los usuarios de tmux ya entienden.

La parte que tmux no tiene: cada panel está marcado working / blocked / done / idle / unknown. Herdr detecta qué agente corre en el panel y rastrea su estado real. Ese estado es exactamente por lo que las apps de teléfono y dashboards web son útiles aquí. En tmux, un cliente de teléfono es solo una pantalla mostrando el texto del buffer. En Herdr, un cliente puede sacar a la superficie “estos tres agentes necesitan tu aprobación” y dejarte responder con un toque.

Por debajo es un único binario Rust. Sin Electron, sin cuenta, sin telemetría, Apache-2.0. El socket vive en ~/.config/herdr/herdr.sock (Windows usa un named pipe bajo %APPDATA%\herdr\). Los plugins lo extienden con un manifiesto herdr-plugin.toml y comandos ordinarios. Más sobre el modelo de confianza abajo. Al escribir esto: estable v0.9.3 (29 de septiembre de 2026) y unas 42,7k estrellas en github.com/herdrdev/herdr. Vuelve a comprobar ambos números el día que leas esto; 0.9.x se mueve rápido.

Clientes Herdr de un vistazo: la tabla de decisión

Diagrama de flujo que empareja tu situación (escritorio, teléfono, navegador, macOS) con el mejor cliente Herdr

Un párrafo honesto antes de las secciones por cliente: de todos los clientes Herdr aquí, para muchos de vosotros la respuesta es “nada más allá de la TUI”. Si te sientas en la misma máquina que corre los agentes, o te va bien ssh más herdr, para aquí. Añade un cliente de terceros cuando aparezca un escenario real. “Quiero aprobar un Claude Code bloqueado desde el sofá” es un escenario real. “Vi un dashboard bonito” no lo es.

Empieza con la TUI integrada (y SSH plano)

Lo que obtienes antes de instalar nada de terceros es ya la mayor parte del valor.

# Linux / macOS
curl -fsSL https://herdr.dev/install.sh | sh
# or: brew install herdr
# or: mise use -g herdr

# Windows (PowerShell): unsigned binary, SmartScreen may warn
irm https://herdr.dev/install.ps1 | iex

# verify
herdr -V
herdr status

herdr status es tu fuente de verdad: muestra la versión del servidor y los clientes conectados. Tras herdr update, herdr también lista qué servidores en ejecución siguen en la versión vieja (desde 0.9.2), con los comandos para reiniciar cada uno.

El bucle diario es pequeño: cd ~/project && herdr, divide con ctrl+b v (la división/arrastre con ratón también funciona), desconecta con ctrl+b q, reconecta después con herdr. SSH plano es también la ruta de teléfono oficialmente recomendada: la TUI se adapta a pantallas estrechas, y los docs muestran uso de teléfono-por-SSH. Clientes de teléfono recomendados por el proyecto: Moshi en iPhone, cualquier app SSH en otros.

Para trabajo remoto, dos cosas importan desde 0.9:

# local UI rendering a remote server's session (keeps local clipboard image paste)
herdr --remote workbox

# multi-machine window (v0.9.0+): one sidebar, local + SSH machines
herdr machine add workbox --label "Build box"
herdr machine status          # v0.9.2+: rechecks every 30s
herdr machine reconnect       # handles MFA in-terminal

Pon el host en ~/.ssh/config primero. La config y los logs viven en ~/.config/herdr/ (config.toml, herdr.log, herdr-server.log, sockets, plugins). Recarga la config con herdr server reload-config.

Mientras estás en la terminal todo el día, haz que la TUI se sienta como casa con plugins de Oh My Zsh e instala zoxide para una navegación de terminal más rápida. Ambos compensan uses o no una web UI.

Mejor Herdr web UI: cinco opciones comunitarias comparadas

No hay herdr web ui oficial (los repos llamados “herdr-web-ui” y “herdr-webui” son ambos proyectos comunitarios). Lo que existe es un clúster de clientes de terceros, todos construidos sobre la API de socket, todos enlazando a loopback por defecto. Aquí está el campo a octubre de 2026 (los conteos de estrellas derivan a diario, así que re-comprueba el día de publicación).

Todos enlazan a loopback. Ninguno trae autenticación real. Tú eres responsable del modelo de exposición. Ese es el tema de la sección de seguridad de abajo.

Una Herdr web UI en el navegador: barra lateral de agentes con chips de estado working/blocked/done, una tarjeta de aprobación para un comando pendiente, y un panel de terminal en vivo

Las piezas son las mismas en las cinco: una barra lateral de agentes con chips de estado, alguna forma de tarjeta de aprobación o respuesta rápida, y una vista de terminal en vivo por panel. Lo que difiere es el transporte (plugin vs binario independiente), la fidelidad (transcripción de chat vs terminal real), y cuánto confías en el modelo de auth.

herdr-web-ui: aprobaciones estilo chat como plugin herdr

La más “app de mensajería” del grupo. Las transcripciones de agentes se renderizan como chat (Claude Code, Codex, omp, omo, gjc, pi), el terminal en vivo está a un clic, y las aprobaciones se convierten en tarjetas pulsables con un paso de validación “comprobado estar actualizado antes de que se envíe tu respuesta”. Es una PWA con una fila de teclas Esc/Tab/Ctrl sobre el teclado, web push, un explorador de archivos, y un código QR apuntando a tu dirección Tailscale.

herdr-web-ui corriendo en un navegador: barra lateral de workspace a la izquierda, paneles de agente con pestañas, y un terminal en vivo mostrando salida de tests

# needs herdr 0.9.0+, Bun 1.4+, Node 18+
herdr plugin install devswha/herdr-web-ui
# serves 127.0.0.1:7317; verify:
ss -tlnp | grep 7317
curl -I http://127.0.0.1:7317

MIT, y se instala como plugin herdr estándar. Buen default si quieres push + aprobaciones en un navegador sin pensar en servidores.

ColliePWA: el cliente Herdr de terceros más popular

ColliePWA (AltanS/collie, 1,2k estrellas) es una PWA mobile-first y el cliente de terceros más popular de cualquier tipo. La pantalla de inicio responde “qué necesita tu input” primero: agentes bloqueados arriba, notificaciones push cuando un agente se bloquea, respuestas rápidas definidas en quick-replies.toml, un pad de teclas especiales, una vista “Changes” de solo lectura para diffs de git, y adjuntos de archivos. Los tokens de emparejado de dispositivo actúan como credenciales de escritura, y las “Crews” ponen varias máquinas detrás de una URL con failover. Seis idiomas de UI. Herdr es el backend primario; tmux y zellij son extras experimentales.

Collie PWA en un teléfono: bandeja de agentes agrupada por proyecto con conteos needs-you, unseen, working, done e idle

curl -fsSL https://colliepwa.dev/install.sh | sh
collie start        # auto-detects herdr/tmux/zellij; binds loopback
# .env: COLLIE_TRUSTED_USER=you@example.com

Corre como servicio systemd de usuario con un bridge Bun. El README es directo sobre la exposición: “Nunca tailscale funnel esto”. Trata la URL como un login root. Ponle tailscale serve delante para que la tailnet inyecte Tailscale-User-Login y los clientes no puedan falsificar la cabecera de identidad. Hay una demo interactiva en colliepwa.dev si quieres tocar la UI antes de instalar. Los builds zip de Windows se entregan desde v1.16.0 (experimental). Referencia cruzada con la sección de móvil: esta es mi elección de teléfono por defecto en Android.

herdrweb: una bandeja de agentes de un solo binario

Construido porque “un teclado de teléfono convierte tmux en un pequeño simulador de rabia” (palabras del autor en r/herdr). Cada agente en cada espacio, ordenado blocked → working → idle, con un panel de terminal crudo, una fila de teclas, una paleta de slash-commands, adjuntar imágenes (el bridge escribe el archivo en el host y suelta la ruta en tu borrador), un visor de diffs Shiki, y PWA + Web Push. Usa RPCs reales (pane.read, agent.prompt, agent.send_keys), sin screen scraping.

bandeja de agentes herdrweb en un teléfono: cada agente en cada espacio ordenado working, done, idle

curl -fsSL https://raw.githubusercontent.com/sarathsp06/herdrweb/main/install.sh | sh
herdrweb -service install && herdrweb -service start   # 127.0.0.1:7331
ss -tlnp | grep 7331

Un binario Go autocontenido (frontend SvelteKit embebido). -service install escribe una unidad systemd de usuario (o launchd en macOS). Sin autenticación, solo-loopback por diseño (“un operador, una máquina”). La exposición recomendada del autor es tailscale serve --bg --https=443 127.0.0.1:7331. Conteo de estrellas pequeño, pero es la arquitectura más limpia del grupo. MIT.

kcosr/herdr-web: un terminal de navegador completo

Si quieres la TUI real en un navegador (vim, htop, TUIs de pantalla completa, no una reescritura de chat), este es el indicado. Un bridge Rust HTTP/WebSocket más un frontend React con un renderer Ghostty web/WASM. Subidas drag-and-drop a paneles, visualización multi-cliente sincronizada (dos navegadores en el mismo panel), un APK Android vía Capacitor, y presets de launcher en ~/.config/herdr-web/launcher-presets.json. Tarballs de release para Linux x86_64 y macOS; sirve http://127.0.0.1:8787; necesita herdr v0.7.2+ corriendo.

kcosr/herdr-web en escritorio: una transcripción de chat junto a paneles de terminal reales en el navegador

alecuba16/herdr-webui: git worktrees y una web UI (con truco)

La opción con más forma de IDE: navegación de workspace y worktree, attach de terminal, una UI de Git completa (status, diffs, staging, commits, stash, blame), un explorador de archivos con editor CodeMirror, y detección de estado de agente para unas 20 CLIs. Tarballs precompilados para Linux x86_64 y macOS; un servidor Rust Axum en http://127.0.0.1:8787; puede auto-instalarse como servicio (install-linux).

alecuba16/herdr-webui: árbol de archivos, vista de cambios git y paneles de agente en una web UI con forma de IDE

El truco, del README: trae su propio backend y puede correr sin binario herdr en absoluto. --backend-mode external-herdr (herdr 0.9.0+) se conecta a un servidor herdr real en su lugar. Eso lo convierte en un producto distinto a los otros de esta sección. Útil, pero no lo que trata este artículo. Menciónalo, no lo elijas como tu cliente herdr primario.

Opciones de app móvil Herdr: responde a agentes desde tu teléfono

La demanda de búsqueda de “herdr mobile app” es real, y es lo segundo que la gente busca tras las web UIs. Incluso hay un listado “Herdr Mobile” en Google Play y un proyecto herdr-mobile-relay en la wild (no he verificado ninguno; comprueba antes de instalar). Las opciones sólidas se dividen en dos campos, y la comunidad es vocal sobre ambos. Los terminal-nativos corren SSH + mosh y dicen cosas como “Mosh es honestamente la respuesta correcta”. Los de tocar-pantalla quieren una bandeja con botones de aprobar: “mis pulgares están hechos para tocar botones de like, no acordes de Ctrl”. Ambos son legítimos. Si quieres el montaje de teléfono terminal-first completo con aprobaciones push, nuestra guía paso a paso de Moshi + Herdr para teléfono cubre ese camino de principio a fin.

Aquí están los comandos por plataforma; las subsecciones de abajo cubren cómo es vivir con cada una.

curl -fsSL https://colliepwa.dev/install.sh | sh
collie start
# .env: COLLIE_TRUSTED_USER=you@example.com
tailscale serve --bg --https=443 127.0.0.1:<collie-port>

# on the host running herdr (needs Node 20+, herdr 0.7.5+, StreamLocal forwarding)
herdr plugin install ZingerLittleBee/Heeler/plugin --ref main --yes
herdr plugin action invoke heeler.pair    # scan the QR in the app

# host
sudo apt install -y mosh
# phone: any SSH client (JuiceSSH on Android, Termius, Moshi on iPhone)
ssh you@server && herdr
# optional: mosh you@server  (survives network switches)

Collie en Android: la ruta PWA

Añade a la pantalla de inicio y tienes un icono de app real, web push cuando un agente se bloquea, respuestas rápidas, y un pad de teclas especiales. Sin Play Store implicada, por diseño (igual en iOS). El emparejado de dispositivo actúa como credencial de escritura, así que una URL robada sola es de solo lectura. Con tailscale serve delante, COLLIE_TRUSTED_USER=you@example.com mapea la cabecera Tailscale-User-Login inyectada a tu identidad; los clientes no pueden falsificar esa cabecera a menos que posean la tailnet. Este es el modelo de seguridad más maduro del ecosistema. Mi elección por defecto en Android.

Heeler para iPhone: iOS nativo con emparejado QR

Heeler (ZingerLittleBee/Heeler, 428 estrellas) es una app SwiftUI nativa en la App Store (fallback a TestFlight si tu país no la tiene; verifica precio y disponibilidad). Es una consola de agentes ordenada blocked-primero, con un terminal en vivo renderizado por libghostty: scrollback nativo, y scroll táctil que conduce TUIs de pantalla completa. El compositor usa el teclado iOS completo (autocorrección, IME, dictado) y envía el mensaje una vez cuando confirmas. Adjuntos SFTP hasta 64 MiB, worktrees, soporte de SSH jump host, push cifrado extremo a extremo con Live Activities (según PRIVACY.md, el relay no puede leer el contenido).

Requisitos del host: Node 20+, herdr 0.7.5+, y sshd con forwarding StreamLocal (el default de OpenSSH). El emparejado es por QR vía un plugin herdr: herdr plugin action invoke heeler.pair, escanea, listo. Apache-2.0, y explícitamente no afiliado al proyecto herdr.

Heeler en iPhone: la consola de agentes listando sesiones con estado working/idle, host y estadísticas de diff por agente

Moshi (iOS + Android): el terminal de app-store que conoce Herdr

Moshi es un terminal móvil construido alrededor de CLIs de agentes en vez de SSH genérico, y está en ambas stores (iOS 17+, Android 10+). El tier gratuito cubre un terminal SSH completo con sesiones ilimitadas, notificaciones push para eventos de agente (rate-limited), dictado, y protección biométrica de claves. Pro ($7,99/mes o $69,99/año, tres dispositivos) desbloquea lo que lo convierte en un cliente Herdr real: transporte Mosh, la UI de multiplexor para tmux/Zellij/Herdr, pegado de imágenes, un visor de diffs, y acciones de bandeja ilimitadas.

Dos partes son específicas de Herdr. El selector de sesión lista sesiones Herdr corriendo con un panel de acordes Ctrl-B y gestos ajustados para pantallas estrechas, y la bandeja de agentes triagea eventos en “Needs you / Working / Done” para que no hagas scroll por el scrollback buscando el panel bloqueado. Emparejar un host instala moshi-hook, un pequeño daemon que lee los propios hooks de los agentes (Claude Code PreToolUse/Notification/Stop, Codex, OpenCode) y convierte los prompts de permiso en pushes Approve/Deny en la pantalla de bloqueo. Etiqueta eventos con $HERDR_SESSION, así que tocar una tarjeta te deja en esa sesión exacta.

Moshi en iPhone corriendo una sesión de Claude Code sobre Mosh, con pegar-capturas-en-chat destacado

Esta es la opción que le daría a alguien que quiere una app, no un flujo PWA. El montaje completo del host (VPS, hooks, trampas de mosh) está en la guía de teléfono Moshi + Herdr. Moshi también entrega una app de escritorio, cubierta abajo.

SSH + Mosh plano: la ruta oficialmente recomendada

Cero servicios extra, cero exposición web, y la respuesta que los docs de herdr dan primero. Cualquier app SSH, ssh you@server, herdr. Si las caídas de red importan, añade mosh: “Mosh es honestamente la respuesta correcta… sin compromisos” es el sentimiento en r/herdr, y coincide con el sesgo de “mantener el conteo de piezas móviles en cero” de todo este artículo. Los usuarios de Reddit corren exactamente esto: herdr + mosh en el dispositivo principal, una app SSH en el teléfono sobre Tailscale.

Dos opciones más que vale la pena conocer, ya que el ecosistema engendra clientes semanalmente. herdr-remote (407 estrellas) da una app de barra de menú macOS, un dashboard web para teléfono, y aprobaciones de un toque desde Telegram (/agents, /reply, /trust, /interrupt, más un /digest diario). Útil si vives en Telegram; su relay enlaza 127.0.0.1:8375 y quiere HERDR_RELAY_TOKEN puesto antes de cualquier tunnel. TermRover (termrover.sh) y ShadowTerm son terminales móviles SSH/mosh comerciales; TermRover entrega una vista “agents fleet” consciente de Herdr entre hosts. Los tres merecen una mirada más cercana en sus propios términos; ninguno está en mi stack por defecto aún.

app de barra de menú macOS de herdr-remote: un desplegable listando doce agentes con su estado idle/working

Apps de escritorio Herdr: Herdr UI, herdrm y Moshi Desktop (y por qué las “manager apps” son una trampa)

Si quieres una herdr desktop app real en vez de una ventana de terminal, herdrm (missuo/herdrm, 623 estrellas) es la respuesta más pulida en macOS. SwiftUI nativo + SwiftTerm, sin Electron, macOS 14+, binario universal, firmado y notarizado, auto-actualizaciones Sparkle. Una barra lateral de Spaces y Agents entre dispositivos locales + SSH (sockets remotos vía ssh -L, reconexión por dispositivo con backoff 1s→30s), búsqueda ⌘K entre cada dispositivo, notificaciones con salto-al-clic, y pegado de archivos/imágenes en paneles de agente (los pegados remotos se transmiten por SSH a una caché de 7 días/50 MB). La diferencia que importa: conecta PTYs reales vía herdr agent attach. Es un cliente, no un envoltorio de chat.

brew install owo-network/brew/herdrm

herdrm en macOS: una barra lateral de Spaces/Agents cubriendo dispositivos locales y SSH junto a una consola de agente en vivo

Orden de auth: claves/agente OpenSSH, luego Tailscale SSH (1.98.0+), luego contraseña guardada en Keychain. El proyecto dice “etapa temprana”; el README reconoce a Heeler por los patrones de transporte.

Herdr UI: una ventana nativa sobre el mismo daemon

Herdr UI (penso/herdr-gpui, Apache-2.0, de Fabien Penso) es el cliente más nuevo de esta lista y el único que es una ventana de escritorio real en vez de un terminal o una página de navegador. Se conecta al daemon Herdr que ya corres: la TUI y la ventana muestran los mismos paneles, y la app nunca instala ni actualiza el propio daemon. Lo que la ventana añade sobre la TUI: despachar trabajo desde issues, revisión lado a lado, checkpoints, Teleport entre máquinas, y una vista general de Devices. Explícitamente no afiliado al proyecto herdr.

# macOS 14.2+ (signed, notarized, universal)
brew install penso/tap/herdr-gpui

# Linux x86_64/ARM64 (glibc 2.39+): checksummed .deb/.rpm/Arch via APT, DNF or pacman
curl -fsSL https://herdrui.dev/install.sh | sh

# Windows (experimental, unsigned, no auto-update; WSL daemons work)
irm https://herdrui.dev/install.ps1 | iex

No hay puerto de escucha que asegurar: pinta los paneles del daemon local en una ventana renderizada por GPU, así que la matemática “toda web UI es un root shell” no aplica. El requisito corre al revés: instala herdr primero, porque Herdr UI solo se conecta a un daemon que ya existe.

Ahora la trampa. herdr.dev/compare distingue el runtime de las “manager apps” de escritorio (Conductor, Emdash, Superset) y apps de terminal (cmux, Warp) cuyos agentes se paran cuando la app cierra. Esas apps poseen el runtime. herdrm, Herdr UI, Heeler, Collie y el resto se conectan a él. Esa única diferencia (cliente vs. dueño del runtime) es toda la razón por la que un ecosistema Herdr puede existir. Si eliges una herramienta que posee los agentes, vuelves a la hoja de ruta de un único proveedor.

Moshi Desktop: la respuesta multiplataforma

herdrm es solo-macOS, pero Moshi Desktop cubre el resto: macOS (Apple Silicon e Intel .dmg), Windows x86_64 .exe, y Linux .AppImage, gratis para todos, unos 11 MB gracias a Tauri en vez de Chromium empaquetado (una reescritura Go renderizada por GPU está en alpha). El mismo equipo también entrega una CLI moshi: curl -fsSL https://getmoshi.app/install.sh | sh y luego moshi abre la UI idéntica en un navegador en 127.0.0.1, que es una web UI loopback para gente que no quiere una app en absoluto.

Es un cliente en el sentido que importa aquí: tus sesiones tmux y Herdr se quedan en el multiplexor, y Desktop las lee a través de moshi-hook (gateway solo-loopback; los hosts remotos viajan sobre tu propio SSH). Encima añade una vista de chat, diffs, comentarios de código fijados a la salida, previews de dev-server que puede tunelar, y aprobaciones de un toque. Cerrarlo nunca mata un agente, que es el test “las manager apps son una trampa” superado. En macOS también se instala por brew tap rjyo/moshi.

Seguridad primero: toda Herdr web UI es un root shell

Trata la URL de cualquier Herdr web UI como un login root a tu máquina. No “un dashboard”. El cliente puede leer tus archivos, correr comandos en tus paneles, y tocar cualquier credencial que tus sesiones de agente guarden. Ese es el producto. La pregunta es solo quién puede alcanzar esa URL.

Realidad de auth por cliente:

• herdrweb no tiene autenticación y se queda solo-loopback por diseño (“un operador, una máquina”).
• kcosr/herdr-web usa allow-listing de host/origen. El propio repo lo dice: eso es una guardia de DNS-rebinding, no autenticación de usuario.
• herdr-web-ui va por defecto a loopback, con QR Tailscale para la ruta del teléfono.
• ColliePWA tiene el modelo más maduro. tailscale serve inyecta Tailscale-User-Login, COLLIE_TRUSTED_USER lo mapea a una identidad, y los tokens de emparejado por dispositivo gobiernan las escrituras.
• alecuba16/herdr-webui enlaza loopback y puede correr sin herdr en absoluto, así que su radio de explosión es lo que haga su propio backend.

El patrón que funciona: enlaza loopback, pon tailscale serve delante (TLS + cabecera de identidad), ábrelo solo desde dispositivos en tu tailnet.

Diagrama del modelo de exposición seguro de una Herdr web UI: Tailscale serve pone delante un cliente solo-loopback

El montaje de referencia: VPS Hetzner + Herdr + Tailscale + un cliente

Este es el camino “córralo esta noche” para un montaje herdr en VPS, y es deliberadamente aburrido. Los agentes viven en un VPS pequeño. Uso Hetzner Cloud para esta clase de carga: una máquina clase CX22 de 4-5 €/mes basta porque los agentes de codificación están limitados por API, no por CPU. El portátil es solo un cliente. Ese es también el propio argumento del equipo herdr para 0.9: “el portátil se está convirtiendo en un cliente”.

Superficie de ops: un binario (herdr), un servicio systemd de usuario (Collie o herdrweb), y Tailscale que probablemente ya corres. Sin Docker, sin bases de datos, cero contenedores que cuidar. Lo único de lo que hacer backup es ~/.config/herdr/.

Arquitectura del montaje Herdr de referencia: agentes en un VPS Hetzner, teléfono y portátil como clientes sobre Tailscale

Prerequisitos

Camino feliz

1. Aprovisiona el VPS, crea un usuario sin root, luego:

sudo apt update && sudo apt install -y tailscale
sudo tailscale up

2. Instala herdr y verifica:

curl -fsSL https://herdr.dev/install.sh | sh
herdr -V && herdr status

3. Empieza trabajo real: cd ~/project && herdr, lanza tu agente en un panel como lo harías normalmente, y desconecta con ctrl+b q.

4. Instala exactamente un cliente. Teléfono-primero: Collie. Bandeja-primero: herdrweb.

# option A: Collie
curl -fsSL https://colliepwa.dev/install.sh | sh
collie start

# option B: herdrweb
curl -fsSL https://raw.githubusercontent.com/sarathsp06/herdrweb/main/install.sh | sh
herdrweb -service install && herdrweb -service start

5. Ponlo al frente en la tailnet:

tailscale serve --bg --https=443 127.0.0.1:7331
# phone browser: https://<host>.tailnet.ts.net

ssh -L 7331:127.0.0.1:7331 you@vps
# laptop browser: http://127.0.0.1:7331

6. Opcional en Mac: brew install owo-network/brew/herdrm, luego herdr machine add workbox --label "Build box" para que una barra lateral cubra portátil y VPS.

Verifica

Qué cuesta / notas de ops

Herdr y cada cliente de este artículo es gratis y open source (Apache-2.0 / MIT), excepto los terminales móviles comerciales (TermRover, ShadowTerm; verifica precios antes de comprar). Tu único coste es el VPS, orden de magnitud 4-5 €/mes. Sin GPU. Si prefieres no alquilar, corre Herdr en casa en un mini PC. Un mini PC compacto como el ASUS DC510 es una máquina always-on sensata, y el modelo Tailscale es idéntico. Backups: tar de ~/.config/herdr al trabajo S3 que ya tengas.

Rollback / desmontaje

collie stop                      # or: herdrweb -service stop / -service uninstall
herdr plugin uninstall <id>      # remove heeler / herdr-web-ui plugins
tailscale serve reset            # unpublish the HTTPS front

herdr server stop solo cuando quieras matar los agentes, no para “he terminado por hoy”. En el VPS todo el stack son 2-3 binarios nativos; la eliminación es borrar la unidad de servicio y el directorio de config.

Trampas de versiones y modos de fallo (0.9.x se mueve rápido)

1. herdr server stop mata procesos de agente. Desconectar ≠ parar. Un reinicio restaura el layout, y reanudar conversación necesita herdr integration install codex|claude|cursor (o un agente auto-reportante, v0.9.2+). Verifica con herdr status.
2. Cliente más nuevo que el servidor tras herdr update. El servidor viejo sigue corriendo; 0.9.2+ lista qué servidores siguen obsoletos, con comandos de reinicio. Reemplazar el servidor remoto pregunta primero porque para procesos de paneles. herdr update --handoff migra en vivo (experimental).
3. Detección de estado incorrecta (Codex falso-idle, spinner de Claude, estados OpenCode V2). Los clientes de transcripción de chat persiguen cambios de UI de agente; los changelogs 0.9.2/0.9.3 están llenos de correcciones de detección. Arreglo: herdr agent explain <agent> --verbose muestra qué regla de detección disparó, y herdr server update-agent-manifests baja manifiestos nuevos.
4. Deriva de API. kcosr/herdr-web vendorea protocolo privado de herdr y necesita actualizaciones por cada release de herdr. Asume que se rompe en actualizaciones major y fija versiones.
5. El push falla silenciosamente sin un contexto seguro HTTPS. http://ip:7331 plano no suscribirá. Enrola por dispositivo, luego usa la notificación de prueba integrada.
6. Rareza de Heeler/SSH. El forwarding StreamLocal debe estar activado (default de OpenSSH; el onboarding avisa si está desactivado). Las máquinas guardadas nunca responden prompts interactivos, así que un cambio de host-key o MFA hace que la máquina muestre “Attention”. Corre herdr --remote host una vez interactivamente, o herdr machine reconnect (v0.9.2). Las claves protegidas por passphrase deben estar en ssh-agent.
7. Estado multi-máquina obsoleto. Las filas de una máquina caída se quedan visibles pero atenuadas y cacheadas; no puedes escribir en ellas. Local siempre abre primero, así que un VPS lento no puede frenar tu portátil.
8. La CLI apunta a un servidor cada vez, incluso en la UI multi-máquina 0.9. herdr --machine <label> (v0.9.1+) reenvía comandos. Los IDs tienen alcance por servidor. Léelos de la salida --json, nunca adivines.
9. No envuelvas tmux entre herdr y el agente. Herdr ve tmux, no el agente, y la detección se rompe. Elige una capa.
10. Rareza de Windows. install.ps1 es un binario sin firmar y SmartScreen puede avisar; install.cmd es el fallback cuando la seguridad de endpoint bloquea el one-liner. Mira herdr.dev/docs/windows-beta para lo que sigue sin soportar (attach de terminal directo, handoff en vivo, bridge de imagen de portapapeles).

Watchlist: Herdr Cloud y lo rápido que se mueve este ecosistema

Herdr Cloud está en lista de espera: un relay que conecta tus máquinas sin montar SSH, con tráfico de terminal cifrado extremo a extremo. El pitch es “Cloud las conecta en vez de alojar los agentes”, así que puede que eventualmente reemplace la fontanería de tailscale serve del montaje de referencia. Apúntate a la lista de espera si tienes curiosidad; no diseñes alrededor de ello todavía.

El ecosistema se mueve rápido. Múltiples clientes independientes salieron a las semanas del soporte multi-máquina de v0.9, y el marketplace de plugins re-indexa cada 30 minutos. El conteo de estrellas (42,7k a octubre de 2026) sigue atrayendo nuevos constructores. Algunos de esos clientes serán abandonware en seis meses. Mantén tu stack en herdr más un cliente, y cambiar el cliente después es barato. Si quieres seguir lo que vale la pena marcar, repos IA que vale la pena estrellar, incluyendo el ecosistema Herdr es la lista corriente.

FAQ

Para terminar

Empieza con la TUI. Añade exactamente un cliente cuando aparezca el escenario de teléfono, y mantén todo detrás de la tailnet. Copia el montaje de referencia si quieres la versión aburrida y verificable de eso.