herdr-agent-multiplexer

name	herdr-agent-multiplexer
description	herdr — Multiplexor de agentes IA en terminal: workspaces, tabs, panes, awareness de agentes, detach/reattach, sin Electron ni GUI
url	https://github.com/ogulcancelik/herdr
category	herramientas
fecha	2026-06-02T00:00:00.000Z

Herdr

Agent multiplexer que vive en tu terminal.

¿Qué hace?

Herdr es un multiplexor de terminal diseñado específicamente para trabajar con agentes IA. Proporciona workspaces, tabs y panes con awareness del estado de los agentes (blocked, working, done, idle). A diferencia de tmux, entiende qué es un agente IA y muestra su estado.

Sin GUI, sin Electron, sin wrapper nativo de macOS. Ves la terminal real del agente, no una interpretación de alguien.

Características clave

• Server y client: Detach/close sin matar los procesos del agente
• Workspaces, tabs, panes: Contenedor a nivel de proyecto, tabs agrupan panes
• Panes reales: Procesos de terminal reales, no vistas reescritas
• Agent awareness: Sidebar muestra blocked, working, done, idle
• Mouse-native: Click, drag, split — sin aprender keybindings
• Detach y reattach: Los agentes siguen corriendo
• Agent session restore: Los agentes oficiales pueden reanudar sesiones nativas tras un restart
• Keybindings explícitas: ctrl+b n para nuevo workspace, v para split vertical, c para tab nuevo
• Escrito en Rust: Binario precompilado, Nix y Homebrew

Casos de uso

1. Gestión de múltiples agentes IA — Varios agentes corriendo en paralelo, cada uno en su pane
2. Sessions persistentes — Detach/close sin perder agentes corriendo
3. Debugging de agentes — Ver la terminal real del agente, copiar texto con drag-select o vim keys
4. Trabajo multi-proyecto — Workspaces separados para cada proyecto
5. Agentes remotos — Reattach desde cualquier terminal a sesiones existentes

Snippets útiles

# Instalar
curl -fsSL https://herdr.dev/install.sh | sh
# o Homebrew
brew install herdr

# Iniciar en el directorio del proyecto
herdr

# Crear nuevo workspace: ctrl+b, shift+n
# Split vertical: ctrl+b, v
# Split horizontal: ctrl+b, minus
# Crear tab: ctrl+b, c
# Cambiar workspace: ctrl+b, w
# Detach: ctrl+b, q
# Reattach desde otra terminal: herdr

# Gestión de sesiones
herdr session attach work          # Attach a sesión nombrada
herdr session stop work            # Detener sesión nombrada
herdr session list                 # Listar sesiones
herdr server stop                  # Detener servidor por defecto
herdr update                       # Actualizar binary
herdr update --handoff             # Actualizar con handoff de sesiones

# Keybindings (prefix por defecto: ctrl+b)
# prefix + n: nuevo workspace
# prefix + v: split vertical
# prefix + c: nuevo tab
# prefix + w: cambiar workspace
# prefix + q: detach
# prefix + [: copy mode
# prefix + shift+n: nuevo workspace (direct)

# Copy mode (vim-like)
# h/j/k/l: mover cursor
# w/b/e: mover por palabras
# v o Space: iniciar selección
# y o Enter: copiar
# q o Esc: salir

Cómo integrarlo

En un proyecto existente

cd /path/to/project
herdr

Herdr inicia o se adjunta a un servidor de sesión en segundo plano. Ejecuta un agente en el pane raíz.

Con agentes oficiales

Las integraciones oficiales de agentes hacen que el reporting de estado y el restore de sesiones nativas sean más fiables. Herdr funciona como multiplexor de terminal sin ellas, pero con ellas obtienes:

• Detección precisa del estado del agente
• Restore de sesiones nativas tras un restart
• Mejor reporting en la sidebar

Como reemplazo de tmux

Feature	tmux	gui managers	herdr
Sessions persistentes	✅	❌	✅
Detach/reattach	✅	❌	✅
Panes, tabs, workspaces	✅	✅	✅
Agent awareness	❌	✅	✅
Vive en tu terminal	✅	❌	✅
Mouse-native	❌	✅	✅
Sin Electron	✅	❌	✅

Pitfalls

• Solo Linux/macOS — no funciona en Windows nativamente
• Prefix keybinding — ctrl+b puede chocar con keybindings de tu terminal
• Server running — un servidor en ejecución sigue usando el proceso viejo tras actualizar. Hay que hacer server stop + herdr de nuevo
• Handoff experimental — herdr update --handoff mueve panes en vivo pero es experimental
• Copy mode depende del terminal — en PuTTY y algunos terminales SSH, hay que usar Shift+drag

Fecha de descubrimiento

2026-06-02 — Trending semanal en GitHub. 3.8k⭐, Rust. Multiplexor de agentes IA en terminal con awareness de estado, workspaces y detach/reattach.