Diferencias

Muestra las diferencias entre dos versiones de la página.

--- cursos:sdd:03-herdr [2026/10/19 00:04] – Arrancar: las integraciones, solo para qué sirven claude
+++ cursos:sdd:03-herdr [2026/10/19 00:22] (actual) – herdr: revisión de coherencia (duplicado de espacios, ejemplos unificados, New worktree, erratas) claude
@@ Línea 4: / Línea 4: @@
 Sirve para lo que pasa en cuanto trabajas con más de un agente a la vez:
-uno implementando, otro revisando la spec y un tercero pasando los tests, cada uno en su panel, y tú sin tener que ir mirándolos uno a uno.
+uno implementando, otro revisando la spec y un tercero pasando los tests, cada uno en su panel, y tú sin tener que ir mirándolos uno a uno: la barra lateral te dice cuál te necesita.
-Por eso es importante que herdr enseña en la barra lateral la lista de agentes, para saber cuál requiere nuestra atención.
 ----
@@ Línea 19: / Línea 18: @@
   * Windows
-<sxh bash>
+<sxh powershell>
 powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
 </sxh>
@@ Línea 68: / Línea 67: @@
 </sxh>
-Se recarga sin parar a los agentes con **menu → reload config** en la barra lateral. Desde la terminal, ''herdr server reload-config'' solo recarga el servidor, y esta parte la dibuja la ventana.
+Se recarga sin parar a los agentes con **menu → reload config** en la barra lateral o con ''Ctrl+b R''. Desde la terminal, ''herdr server reload-config'' solo recarga el servidor, y esta parte la dibuja la ventana.
 El nombre se le pone al panel con el botón derecho → **Rename pane** (en la [[#con_el_raton|sección 2]] está con capturas).
@@ Línea 75: / Línea 74: @@
 <sxh plain>
-○ daw-proyecto
+○ implementa
-  daw-proyecto · claude
+  reservas-api · claude
-○ sdd
+○ revisa
-  daw-proyecto · claude
+  reservas-api · claude
 </sxh>
@@ Línea 164: / Línea 163: @@
 <note tip>El menú del panel cambia según el caso: si el panel ya tiene nombre añade **Clear pane name**, y si hay otro panel al lado, **Swap with focused pane**. Las opciones son las mismas, pero no siempre están en la misma posición: léelas antes de pinchar.</note>
-==== Crear un espacio de trabajo ====
+==== Gestionar los espacios de trabajo ====
-Al arrancar, herdr abre un espacio de trabajo en la carpeta desde la que lo lanzas. Para trabajar en otro proyecto a la vez, se crea otro espacio:
-  * Crear un espacio de trabajo: clic en **new**, al pie de la lista de espacios de la barra lateral.
   * Cambiarle el nombre: botón derecho sobre el espacio, **Rename**.
   * Cerrarlo, con todas sus pestañas y paneles: botón derecho, **Close**.
-<note important>El espacio nuevo se abre en la **carpeta del panel en el que estás**, no en la del otro proyecto. Si lo creas con **new**, haz ''cd'' en su panel al proyecto que toca. O mejor, créalo desde cualquier panel con la orden, que le da la carpeta y el nombre de una vez:
+<note important>Con **new**, el espacio se abre en la **carpeta del panel en el que estás**, no en la del otro proyecto, y hay que hacer ''cd''. Para otro proyecto, mejor crearlo desde cualquier panel con la orden, que le da la carpeta y el nombre de una vez:
 <sxh bash>
-herdr workspace create --cwd ~/proyectos/tienda --label tienda
+herdr workspace create --cwd ~/proyectos/tienda-web --label tienda-web
 </sxh>
 </note>
@@ Línea 181: / Línea 177: @@
 ===== 3. Worktrees de Git =====
-Si uno de nuestros workspaces es un worktree de Git , simplemente es como un nuevo workspace en Herdr.
-Podemos hacer que todos los worktree de git aparezcan agrupados si abrimos el worktree con el menú de **Open worktree...** del workspace de Herdr.
-Para ello pulsamos con el botón derecho sobre el espacio del proyecto → **Open worktree...**, y se elige el worktree de la lista. La opción solo sale si la carpeta del espacio es un repositorio Git.
+Un worktree de Git es una carpeta más, así que en herdr es un espacio de trabajo más. Si se crea desde herdr, además **cuelga del espacio del proyecto** y los worktrees del repositorio salen agrupados. Es lo normal para tener un agente por spec, cada uno en su rama.
+Botón derecho sobre el espacio del proyecto (la opción solo sale si su carpeta es un repositorio Git):
+  * **New worktree**: se escribe el nombre de la rama y herdr crea la rama, el worktree y su espacio de trabajo de una vez.
+  * **Open worktree...**: para un worktree que ya existe; se elige de la lista.
 {{:cursos:sdd:herdr-worktree-menu.png?700|}}
@@ Línea 197: / Línea 196: @@
 ===== 4. El skill de herdr: que el agente maneje herdr =====
-Lo siguiente que podemos hacer es que desde claude code o opencode podamos decirle que queremos hacer cosas en herdr. Lo único que hay que hacer es añadir a nuestro claude code o opencode el skill para manejar herdr.
+Con el skill de herdr, el agente (OpenCode, Claude Code...) puede manejar herdr por ti. Se instala así:
 <sxh bash>
@@ Línea 203: / Línea 202: @@
 </sxh>
-A partir de ahí, desde OpenCode o claude code dentro de herdr se le puede pedir que abra paneles, lance órdenes en ellos, lea su salida y espere a que terminen. Por ejemplo:
+A partir de ahí, desde OpenCode o Claude Code dentro de herdr se le puede pedir que abra paneles, lance órdenes en ellos, lea su salida y espere a que terminen. Por ejemplo:
   * Lanzar los tests en otro panel sin quitarte el foco:
@@ Línea 232: / Línea 231: @@
 ===== 5. Usando herdr =====
-Puedes cerrar herdr cuando quieras, aunque la terminal avise de que hay un proceso en ejecución: los agentes siguen trabajando y, al volver a ejecutar ''herdr'', todo está como lo dejaste. Si reinicias el ordenador vuelven los espacios de trabajo, pestañas y paneles, pero los agentes solo recuperan su conversación si tienen la [[#arrancar|integración]].
+==== La lista de agentes ====
-==== La lista de agentes: la verdadera ventaja de herdr ====
+Lo que hace útil a herdr es la lista de agentes, abajo a la izquierda bajo **agents**: están **todos los agentes que tienes en marcha**, de todos los espacios de trabajo y pestañas, y de un vistazo sabes **cuál necesita tu atención**. Para llegar hasta él no hay que buscar su espacio ni su pestaña: **clic en el agente** y estás en su panel.
-Abajo a la izquierda, bajo **agents**, herdr enseña **todos los agentes que tienes en marcha**, de todos los espacios de trabajo y pestañas, cada uno con un punto de color que dice en qué estado está:
+{{:cursos:sdd:herdr-estados.png?300|}}
+==== El estado de cada agente ====
+Cada agente está en un estado, marcado con un punto de color, que dice si te necesita:
 ^ Color ^ Estado ^ Qué significa ^ Qué haces tú ^
+| <color #40a02b>○</color> Verde, hueco | ''idle'' | Ha terminado y ya lo has visto | Darle la siguiente tarea |
 | <color red>●</color> Rojo | ''blocked'' | Espera una respuesta: un permiso, una pregunta, una decisión | **Ir a contestarle** |
-| <color blue>●</color> Azul | ''done'' | Ha terminado y aún no lo has mirado | Revisar el resultado |
+| <color #179299>●</color> Verde azulado, relleno | ''done'' | Ha terminado y aún no lo has mirado | Revisar el resultado |
 | <color #c9a000>●</color> Amarillo | ''working'' | Está trabajando | Nada, déjalo |
-| <color green>●</color> Verde | ''idle'' | Ha terminado y ya lo has visto | Darle la siguiente tarea |
-Haciendo **clic en un agente** de la lista vas directamente a su panel, esté en el espacio de trabajo y la pestaña que esté.
-Con el teclado, ''Ctrl+b g'' abre la misma lista; dentro de ella, ''b'' deja solo los bloqueados.
-Esa es la verdadera ventaja de herdr frente a tmux: lanzas varios agentes, no tienes que ir mirándolos uno a uno y te basta un vistazo a la lista para saber **cuál requiere tu atención**. Cuando un punto se pone rojo o azul, clic y a atenderlo.
+Cuando un punto se pone rojo o verde azulado, clic y a atenderlo.
 El estado también **sube** a la lista de espacios de trabajo: un agente ''blocked'' marca como bloqueados su pestaña y su espacio, así que ves qué proyecto te necesita aunque tengas muchos.
 <note warning>''idle'' **no quiere decir que haya hecho bien el trabajo**, solo que ha vuelto al prompt. Y si el agente saca una pregunta con un aspecto que herdr no conoce, puede marcarlo como ''idle'' en vez de ''blocked''. Antes de darle la siguiente tarea, mira qué ha dejado en pantalla.</note>
+==== Cerrar herdr ====
+Los agentes no corren dentro de la ventana de herdr, sino en un **proceso aparte** (el servidor de herdr), así que puedes cerrar herdr cuando quieras, aunque la terminal avise de que hay un proceso en ejecución: los agentes siguen trabajando y, al volver a ejecutar ''herdr'', todo está como lo dejaste. Si reinicias el ordenador vuelven los espacios de trabajo, pestañas y paneles, pero los agentes solo recuperan su conversación si tienen la [[#arrancar|integración]].
 ----
@@ Línea 269: / Línea 276: @@
 | ''R'' | Recargar ''config.toml'' |
 | ''b'' | Mostrar u ocultar la barra lateral |
-| ''g'' | muestra la lista de paneles para ir a uno de ellos |
+| ''g'' | Ir a cualquier agente o terminal (lista con filtros) |
 ==== Espacios de trabajo ====
@@ Línea 313: / Línea 320: @@
 ----
-===== 7. Enlaces =====
+===== 7. Más información =====
   * [[https://herdr.dev|herdr.dev]]: web oficial.