Diferencias

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

--- cursos:sdd:03-herdr [2026/10/18 22:52] – Quitada la sección de plugins; renumeradas las siguientes 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 32: / Línea 31: @@
 </sxh>
-La primera vez sale un asistente que propone **instalar las integraciones** de los agentes que encuentra en el ''PATH'': si tienes OpenCode y Claude Code, instala las dos. Di que sí: qué son está en la [[#integracionesrecuperar_la_conversacion_tras_reiniciar|sección 5]].
+La primera vez pregunta si quieres **instalar las integraciones** de los agentes que encuentra en el ''PATH''. Di que sí: sirven para que herdr sepa **en qué estado está cada agente**. Si no las instalaste o instalas un agente después, están en los ajustes (''Ctrl+b s'') → **integrations**; tras instalarla, sal del agente y vuelve a lanzarlo para que la cargue.
+{{:cursos:sdd:herdr_integraciones.png?600|}}
 Se abre la interfaz: a la izquierda la **barra lateral** con los espacios de trabajo y los agentes, y a la derecha el panel con una shell. En esa shell se arranca el agente como siempre:
@@ Línea 66: / 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 3]] está con capturas).
+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).
 El nombre sale en el borde del panel y en la primera línea de la lista; debajo, el espacio y el agente:
 <sxh plain>
-○ daw-proyecto
+○ implementa
-  daw-proyecto · claude
+  reservas-api · claude
-○ sdd
+○ revisa
-  daw-proyecto · claude
+  reservas-api · claude
 </sxh>
 ----
-===== 2. Cliente y servidor: cerrar no es parar =====
+===== 2. Espacios de trabajo, pestañas y paneles =====
-herdr arranca un **servidor en segundo plano** que es el dueño de los paneles, y la ventana que ves es solo un **cliente** conectado a él. Por eso:
-  * **Cerrar la terminal no para nada**: los agentes siguen trabajando.
-  * Para salir a propósito dejando todo en marcha, ''Ctrl+b q''.
-  * Para volver, otra vez:
-<sxh bash>
-herdr
-</sxh>
-  * Para acabar de verdad y parar todos los paneles:
-<sxh bash>
-herdr server stop
-</sxh>
-<note important>Lo que sobrevive a cerrar la ventana **no sobrevive a reiniciar el ordenador** (ni a ''herdr server stop''). Al volver, herdr recupera la distribución de paneles y sus carpetas, pero los procesos son nuevos. Para que además recupere **la conversación del agente**, instala su integración (sección 5).</note>
-Como el servidor sigue vivo, puedes dejar a un agente implementando en el ordenador del instituto, entrar por ''ssh'' desde casa o desde el móvil, ejecutar ''herdr'' y ver por dónde va.
-==== Guardar un espacio de trabajo y volver a cargarlo ====
-herdr no tiene una orden para guardar: **guarda solo y continuamente** la sesión entera (espacios de trabajo, pestañas, paneles, sus nombres y sus carpetas) en ''~/.config/herdr/session.json'', y la vuelve a montar al arrancar.
-Para tener la distribución de cada proyecto guardada aparte y cargarla cuando toque, se usa una **sesión con nombre**: otro herdr independiente, con sus propios espacios y paneles.
-  * Crear la sesión, o volver a ella si ya existe:
-<sxh bash>
-herdr --session sdd
-</sxh>
-  * Se montan en ella los espacios, pestañas y paneles del proyecto. No hay que guardar nada.
-  * Cerrarla parando sus paneles. Queda guardada:
-<sxh bash>
-herdr session stop sdd
-</sxh>
-  * Cargarla otro día. Vuelve la misma distribución en las mismas carpetas, y los agentes con su conversación si tienen la integración (sección 5):
-<sxh bash>
-herdr --session sdd
-</sxh>
-  * Ver las sesiones que hay y cuáles están en marcha:
-<sxh bash>
-herdr session list
-</sxh>
-  * Borrar una que ya no se usa. Tiene que estar parada:
-<sxh bash>
-herdr session delete sdd
-</sxh>
-<note important>''herdr'' a secas abre siempre la sesión ''default'', no la última que usaste. Para volver a una sesión con nombre hay que dar su nombre con ''--session''.</note>
-<note tip>Si sales con ''Ctrl+b q'' en vez de pararla, la sesión sigue en marcha, y ''herdr --session sdd'' te devuelve a ella con los agentes trabajando.</note>
-----
-===== 3. Espacios de trabajo, pestañas y paneles =====
 herdr organiza los terminales en tres niveles:
@@ Línea 220: / 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 236: / Línea 176: @@
 ----
-===== 4. El estado de los agentes =====
+===== 3. Worktrees de Git =====
-Es lo que diferencia a herdr de tmux. Cada agente aparece en la barra lateral con su estado:
+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.
-^ Estado ^ Qué significa ^ Qué haces tú ^
+Botón derecho sobre el espacio del proyecto (la opción solo sale si su carpeta es un repositorio Git):
-| ''working'' | Está trabajando | Nada, déjalo |
-| ''blocked'' | Espera una respuesta: un permiso, una pregunta, una decisión | **Ir a contestarle** |
-| ''done'' | Ha terminado y aún no lo has mirado | Revisar el resultado |
-| ''idle'' | Ha terminado y ya lo has visto | Darle la siguiente tarea |
-El estado **sube**: un agente ''blocked'' marca como bloqueados su pestaña y su espacio de trabajo, así que con un vistazo a la barra lateral sabes qué proyecto te necesita.
+  * **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.
-Para saltar directamente al agente que te interesa, ''Ctrl+b g'' abre una lista con todos los agentes y terminales; dentro de ella, ''b'' deja solo los bloqueados.
+{{:cursos:sdd:herdr-worktree-menu.png?700|}}
-<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>
+Cada worktree es un espacio de trabajo completo, con sus pestañas y paneles, que en la lista de espacios cuelga del proyecto. Aquí, ''login'' y ''pagos'' de ''reservas-api'':
-----
+{{:cursos:sdd:herdr-worktree-grupo.png?700|}}
-===== 5. Integraciones: recuperar la conversación tras reiniciar =====
+<note>Cerrar el espacio del proyecto cierra todo el grupo, pero no borra ni las carpetas ni las ramas.</note>
-Sin integración, herdr ya ve los agentes: los reconoce por el proceso y **lee su pantalla** para saber si están trabajando o esperando. La integración es un pequeño añadido que herdr **escribe en la configuración del propio agente** para que el agente le cuente cosas directamente por su socket, sin que herdr tenga que adivinarlas.
+----
-Lo que se gana:
+===== 4. El skill de herdr: que el agente maneje herdr =====
+Con el skill de herdr, el agente (OpenCode, Claude Code...) puede manejar herdr por ti. Se instala así:
-  * **Recuperar la conversación**: el agente le dice a herdr en qué sesión está. Si el servidor se reinicia (reinicio del ordenador, ''herdr server stop''), herdr vuelve a abrir el agente **con esa misma conversación**, en lugar de una shell vacía. Esto lo hacen todas las integraciones.
-  * **Estado más fiable**: en algunos agentes, OpenCode entre ellos, el agente informa él mismo de si está ''working'' o ''blocked''. Leer la pantalla falla cuando sale una pregunta con un aspecto que herdr no conoce; el aviso del propio agente, no.
-Qué escribe en cada agente:
-^ Agente ^ Qué instala ^ Dónde ^ Recupera la conversación ^ Informa del estado ^
-| OpenCode | Un plugin de OpenCode | ''~/.config/opencode/plugins/'' | ✓ | ✓ |
-| Claude Code | Un //hook// ''SessionStart'' | ''~/.claude/hooks/'' y ''settings.json'' | ✓ | |
-Los plugins de OpenCode están en [[cursos:sdd:03-opencode#plugins|su tema]] y los //hooks// se verán en el tema 9; aquí basta con saber que herdr los instala y los quita solo.
-Las órdenes, por si no las instalaste en el asistente o instalas un agente después:
-  * Instalar la integración de OpenCode:
 <sxh bash>
-herdr integration install opencode
+npx skills add herdrdev/herdr --skill herdr -g
 </sxh>
-  * La de Claude Code:
+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:
-<sxh bash>
-herdr integration install claude
+  * Lanzar los tests en otro panel sin quitarte el foco:
+<sxh plain>
+en herdr, abre un panel abajo, lanza npm test y avísame cuando acabe
 </sxh>
-  * Ver cuáles tienes instaladas y si están desactualizadas:
+  * Leer la salida de otro panel y actuar sobre ella:
-<sxh bash>
+<sxh plain>
-herdr integration status
+lee en herdr la salida del panel de los tests y arregla lo que falle
 </sxh>
-  * Quitarla, si ya no la quieres. Borra lo que instaló y deja el resto de tu configuración intacta:
+  * Arrancar otro agente que revise el trabajo:
-<sxh bash>
+<sxh plain>
-herdr integration uninstall opencode
+en herdr, abre un panel a la derecha con otro opencode que revise specs/login/design.md contra requirements.md, espera a que termine y resúmeme lo que encuentre
 </sxh>
-<note important>Tras instalar la integración hay que **reiniciar el agente** (salir de OpenCode y volver a lanzarlo) para que cargue el plugin. Y si un día herdr deja de recuperar las conversaciones tras una actualización, mira ''herdr integration status'': la integración puede haberse quedado vieja y basta con volver a instalarla.</note>
+Todo lo que hace queda en sus paneles, a la vista, y puedes intervenir en cualquier momento.
+<note warning>
+El skill es para pedirle cosas **a mano mientras trabajas**.
+Instálalo solo con ''-g'', en tu usuario y nunca en el proyecto, y que **ningún skill ni comando del proyecto dependa de herdr**: en CI no hay herdr y esa parte no se ejecutaría.
+</note>
-<note tip>También se instalan desde la pestaña de integraciones de los ajustes de herdr, que es la misma pantalla que abre el asistente del primer arranque.</note>
 ----
-===== 6. Worktrees de Git =====
+===== 5. Usando herdr =====
-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.
+==== La lista de agentes ====
-{{:cursos:sdd:herdr-worktree-menu.png?700|}}
+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.
-Cada worktree es un espacio de trabajo completo, con sus pestañas y paneles, que en la lista de espacios cuelga del proyecto. Aquí, ''login'' y ''pagos'' de ''reservas-api'':
+{{:cursos:sdd:herdr-estados.png?300|}}
-{{:cursos:sdd:herdr-worktree-grupo.png?700|}}
-<note>Cerrar el espacio del proyecto cierra todo el grupo, pero no borra ni las carpetas ni las ramas.</note>
+==== El estado de cada agente ====
-----
+Cada agente está en un estado, marcado con un punto de color, que dice si te necesita:
-===== 7. El skill de herdr: que un agente maneje a otros =====
+^ Color ^ Estado ^ Qué significa ^ Qué haces tú ^
-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.
+| <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 #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 |
-<sxh bash>
-npx skills add herdrdev/herdr --skill herdr -g
-</sxh>
-A partir de ahí, desde OpenCode o claude code dentro de herdr se le puede pedir:
-<sxh plain>
+Cuando un punto se pone rojo o verde azulado, clic y a atenderlo.
-abre un panel a la derecha con otro opencode que revise specs/login/design.md contra requirements.md, espera a que termine y resúmeme lo que encuentre
-</sxh>
+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>
-El agente revisor queda en su panel, a la vista, y puedes intervenir en cualquier momento.
+==== Cerrar herdr ====
-<note>El skill solo actúa si el agente está **dentro de un panel de herdr** (lo sabe por la variable ''HERDR_ENV=1''). Fuera de herdr se niega, para no tocar una sesión que no es suya.</note>
+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]].
 ----
-===== 8. Atajos de teclado =====
+===== 6. Atajos de teclado =====
 ''Ctrl+b'' pone herdr en **modo prefijo**: la siguiente tecla que pulses no va al panel, sino a herdr, que la toma como una orden. Se pulsa ''Ctrl+b'', se suelta y se pulsa la tecla de la orden. Hecha la orden, se vuelve al panel.
@@ Línea 348: / 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 392: / Línea 320: @@
 ----
-===== 9. Enlaces =====
+===== 7. Más información =====
   * [[https://herdr.dev|herdr.dev]]: web oficial.