logongas

Herramientas de usuario

Herramientas del sitio

Ocultar Menú
Traza:
cursos:sdd:03-herdr

Diferencias

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

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión		Revisión previa
cursos:sdd:03-herdr [2026/10/18 22:48] – Presentación: la lista de agentes es la de la barra lateral; erratas claudecursos: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:  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   * Windows
-<sxh bash>+<sxh powershell>
 powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
 </sxh> </sxh>
Línea 32: Línea 31:
 </sxh> </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: 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> </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: 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> <sxh plain>
-○ daw-proyecto +○ implementa 
-  daw-proyecto · claude +  reservas-api · claude 
-○ sdd +○ revisa 
-  daw-proyecto · claude+  reservas-api · claude
 </sxh> </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: 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> <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**.   * Cambiarle el nombre: botón derecho sobre el espacio, **Rename**.
   * Cerrarlo, con todas sus pestañas y paneles: botón derecho, **Close**.   * 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> <sxh bash>
-herdr workspace create --cwd ~/proyectos/tienda --label tienda+herdr workspace create --cwd ~/proyectos/tienda-web --label tienda-web
 </sxh> </sxh>
 </note> </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. +
- +
-<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> +
- +
----- +
- +
-===== 5. Integraciones: recuperar la conversación tras reiniciar ===== +
- +
-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: +
- +
-  * **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 +
-</sxh> +
- +
-  * La de Claude Code: +
-<sxh bash> +
-herdr integration install claude +
-</sxh> +
- +
-  * Ver cuáles tienes instaladas y si están desactualizadas: +
-<sxh bash> +
-herdr integration status +
-</sxh> +
- +
-  * Quitarla, si ya no la quieres. Borra lo que instaló y deja el resto de tu configuración intacta: +
-<sxh bash> +
-herdr integration uninstall opencode +
-</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> +
- +
-<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 ===== +
-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.+
  
 {{:cursos:sdd:herdr-worktree-menu.png?700|}} {{:cursos:sdd:herdr-worktree-menu.png?700|}}
Línea 315: Línea 195:
 ---- ----
  
-===== 7. El skill de herdr: que un agente maneje a otros ===== +===== 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> <sxh bash>
Línea 322: Línea 202:
 </sxh> </sxh>
  
-A partir de ahí, desde OpenCode o claude code dentro de herdr se le puede pedir:+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:
 <sxh plain> <sxh plain>
-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+en herdr, abre un panel abajo, lanza npm test y avísame cuando acabe
 </sxh> </sxh>
  
-El agente revisor queda en su panel, a la vista, y puedes intervenir en cualquier momento.+  * Leer la salida de otro panel y actuar sobre ella: 
 +<sxh plain> 
 +lee en herdr la salida del panel de los tests y arregla lo que falle 
 +</sxh> 
 + 
 +  * Arrancar otro agente que revise el trabajo: 
 +<sxh plain> 
 +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> 
 + 
 +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>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> 
  
 ---- ----
  
-===== 8. Plugins =====+===== 5. Usando herdr =====
  
-Los plugins añaden flujos de trabajo que herdr no trae de serie. Se instalan **desde GitHub**, con el formato ''usuario/repositorio/carpeta'', y valen para todas las sesiones. Se buscan en el [[https://herdr.dev/plugins/|marketplace]].+==== La lista de agentes ====
  
-  * Instalar un plugin. Por ejemplo, el que crea de golpe una distribución de tres paneles (editor, ficheros y tareas): +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.
-<sxh bash> +
-herdr plugin install ogulcancelik/herdr-plugin-examples/dev-layout-bootstrap +
-</sxh>+
  
-  * Ver los instalados: +{{:cursos:sdd:herdr-estados.png?300|}}
-<sxh bash> +
-herdr plugin list +
-</sxh>+
  
-  * Ver las acciones de un plugin y ejecutar una: 
-<sxh bash> 
-herdr plugin action list --plugin examples.dev-layout-bootstrap 
-herdr plugin action invoke examples.dev-layout-bootstrap.setup 
-</sxh> 
  
-  * Actualizar todos. Para uno solo, se añade su id: +==== El estado de cada agente ====
-<sxh bash> +
-herdr plugin update +
-</sxh>+
  
-  * Desactivarlo sin desinstalarlo, y volver a activarlo: +Cada agente está en un estado, marcado con un punto de color, que dice si te necesita:
-<sxh bash> +
-herdr plugin disable examples.dev-layout-bootstrap +
-herdr plugin enable examples.dev-layout-bootstrap +
-</sxh>+
  
-  * Desinstalarlo: +^ Color ^ Estado ^ Qué significa ^ Qué haces tú ^ 
-<sxh bash> +| <color #40a02b>○</color> Verde, hueco | ''idle'' | Ha terminado y ya lo has visto | Darle la siguiente tarea | 
-herdr plugin uninstall examples.dev-layout-bootstrap +| <color red>●</color> Rojo | ''blocked'' | Espera una respuesta: un permiso, una pregunta, una decisión | **Ir a contestarle** | 
-</sxh>+| <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 |
  
-Para no escribir la orden cada vez, una acción se asocia a una tecla en ''~/.config/herdr/config.toml'': 
  
-<sxh ini; title: ~/.config/herdr/config.toml> 
-[[keys.command]] 
-key = "prefix+shift+l" 
-type = "plugin_action" 
-command = "examples.dev-layout-bootstrap.setup" 
-description = "distribución de desarrollo" 
-</sxh> 
  
-Y se recarga la configuración sin parar los paneles:+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.
  
-<sxh bash> +<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> 
-herdr server reload-config + 
-</sxh>+==== Cerrar herdr ====
  
-<note warning>Un plugin es **código que se ejecuta con tu usuario**, y el marketplace no revisa nada: basta con que un repositorio se etiquete como ''herdr-plugin'' para aparecer. ''herdr plugin install'' enseña antes de instalar qué va a ejecutar: léelo, e instala solo de autores en los que confíes.</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]].
  
 ---- ----
  
-===== 9. 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. ''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 404: Línea 276:
 | ''R'' | Recargar ''config.toml'' | | ''R'' | Recargar ''config.toml'' |
 | ''b'' | Mostrar u ocultar la barra lateral | | ''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 ==== ==== Espacios de trabajo ====
Línea 448: Línea 320:
 ---- ----
  
-===== 10. Enlaces =====+===== 7. Más información =====
  
   * [[https://herdr.dev|herdr.dev]]: web oficial.   * [[https://herdr.dev|herdr.dev]]: web oficial.
   * [[https://herdr.dev/docs/|Documentación]]: guía y referencia de órdenes y configuración.   * [[https://herdr.dev/docs/|Documentación]]: guía y referencia de órdenes y configuración.
   * [[https://github.com/herdrdev/herdr|Repositorio]]: código y versiones publicadas.   * [[https://github.com/herdrdev/herdr|Repositorio]]: código y versiones publicadas.
-  * [[https://herdr.dev/plugins/|Marketplace]]: plugins de la comunidad. 
  
  
cursos/sdd/03-herdr.1792356480.txt.gz · Última modificación: por claude