| name | herdr-detach |
| description | Deriva un prompt a otro agente CLI en un pane de herdr, opcionalmente esperando la respuesta. Usar cuando queres delegar trabajo a claude, opencode o codex en una sesion paralela visible. |
Deriva un prompt a otro agente CLI (claude, opencode, codex) corriendo en un pane de herdr, opcionalmente bloqueando hasta que el agente termine y devuelve la respuesta. Usar cuando queres delegar trabajo a una sesion paralela visible en otro pane y, segun el caso, seguir trabajando o esperar la respuesta antes de continuar.
Asume que la sesion actual corre dentro de herdr. El modo --here se ancla al pane que originó la invocacion via HERDR_PANE_ID, no al pane enfocado.
Argumentos
/herdr-detach [--wait] [--here|--new] <agente> <prompt>
<agente>: claude, opencode o codex. Otros valores abortan.<prompt>: texto libre enviado al agente derivado. Todo lo que sigue al agente se concatena.--wait: espera hasta status idle o done y devuelve el buffer visible. Default: fire-and-forget.--here: split a la derecha del pane origen. Default.--new: crea un workspace nuevo dedicado.
El pane derivado siempre queda abierto.
Pre-Flight
- Verificar
herdr en PATH con command -v herdr. Si falta, abortar: herdr no esta instalado o no esta en PATH. Ver https://herdr.dev.
- Verificar server con
herdr status 2>&1. Si server.status no es running, abortar pidiendo al usuario abrir herdr.
- Parsear argumentos: extraer
--wait, --here, --new; --here y --new son excluyentes; default --here.
- Validar
<agente> contra {claude, opencode, codex}. Si el prompt queda vacio, pedirlo al usuario.
- Verificar binario del agente con
command -v <AGENT>. Si falta, abortar.
- Verificar integracion:
herdr integration status 2>&1. Si el agente esta not installed u outdated, correr herdr integration install <AGENT> sin preguntar. Si falla, reportar stderr y abortar.
- Para
--here, exigir HERDR_ENV=1 y HERDR_PANE_ID no vacio. Resolver pane_id, workspace_id, tab_id, cwd con herdr pane get "$HERDR_PANE_ID".
- Para
--new, crear workspace con cwd del pane origen: herdr workspace create --cwd <CWD_BASE> --label "detach-<AGENT>" --no-focus y capturar root_pane y terminal_id.
Lanzar Agente
Definir TS=$(date +%s) y AGENT_NAME="detach-<AGENT>-<TS>".
Para --here:
- Snapshotear terminales existentes:
TERMS_BEFORE=$(herdr pane list --workspace <WORKSPACE_ID> | jq -r '.result.panes[].terminal_id' | sort).
- Lanzar con
herdr agent start "$AGENT_NAME" --workspace <WORKSPACE_ID> --tab <TAB_ID> --cwd <CWD_BASE> --split right --no-focus -- <AGENT>.
- No correr
pane split por separado.
Para --new:
- Reusar el
root_pane del workspace: herdr pane run "$ROOT_PANE_ID" "<AGENT>".
- Esperar deteccion del agente sobre
ROOT_TERM y renombrar: herdr agent rename "$ROOT_TERM" "$AGENT_NAME".
- No usar
agent start sin --split, porque crea un pane extra.
Post-launch, cerrar solo shells pelados (agent: null, agent_status: unknown) creados por este launch. Operar por terminal_id, nunca por pane_id, porque herdr renumera pane ids al cerrar. Re-resolver el pane id del agente despues de cualquier cierre.
Dialogos De Pre-Arranque
Loop hasta 4 iteraciones leyendo herdr agent read "$AGENT_NAME" --source visible --lines 40 --format text.
- Trust directory: mandar
Enter.
- Bypass permissions: mandar
Down + Enter.
- Codex update available: mandar
Down + Enter para Skip; nunca Enter directo.
- Si no hay dialogo conocido, declarar listo solo si se cumplen las 3 condiciones:
agent_status == idle, prompt char (❯, ›, ┃) al inicio de la ultima linea no vacia, y ausencia de menus (^[0-9]+., Press enter to continue, select an option, Update available).
Si no se resuelve, abortar pidiendo confirmacion manual en el pane.
Enviar Prompt
Escribir el prompt a un temp file para evitar shell quoting. Enviar con:
herdr agent send "$AGENT_NAME" "$(cat "$PROMPT_FILE")"
sleep 0.5
PANE_ID=$(herdr agent get "$AGENT_NAME" | jq -r .result.agent.pane_id)
herdr pane send-keys "$PANE_ID" Enter
Confirmar que el input se envio: si queda como pasted text o el agente no transiciona a working en 5s, mandar Enter una segunda vez. Cap maximo: 2 Enters totales.
Esperar Opcionalmente
Solo con --wait:
- Primero confirmar transicion a
working para evitar falso positivo de idle previo.
- Esperar con
herdr agent wait "$AGENT_NAME" --status idle --timeout 600000.
- Dormir 1-2s y leer
herdr agent read "$AGENT_NAME" --source visible --lines 80 --format text.
- Si el buffer es largo, devolver solo las ultimas 60 lineas y avisar.
Reporte
Fire-and-forget:
## /herdr-detach report
- modo: fire-and-forget
- agente: <AGENT>
- ubicacion: <here | new>
- workspace_id: <WORKSPACE_ID>
- agent_name: <AGENT_NAME>
- pane_id: <PANE_ID>
- prompt enviado (primeras 80 chars): <PROMPT[:80]>...
Para inspeccionar: `herdr agent read <AGENT_NAME> --source visible`
Para volver focused: `herdr agent focus <AGENT_NAME>`
Para cerrar: `herdr pane close <PANE_ID>`
Con --wait, incluir status final y el bloque visible del pane. En ambos modos, re-resolver pane_id justo antes de reportar.
MUST DO
- Validar
herdr, server, agente e integracion antes de lanzar.
- Anclar
--here a HERDR_PANE_ID, nunca al focus state.
- Usar
AGENT_NAME como handle estable para agent send/read/wait/focus.
- Re-resolver
pane_id antes de cualquier pane send-keys o pane close.
- Manejar dialogos conocidos de forma segura.
- Pasar prompt via temp file.
- Dejar el pane derivado abierto.
MUST NOT DO
- No arrancar
herdr desde el skill si el server no esta corriendo.
- No remediar ausencia de
claude, opencode o codex.
- No focusear el pane derivado por default.
- No guardar y reutilizar
pane_id sin re-resolver.
- No mandar Enter directo en el dialogo de update de codex.
- No interpolar el prompt crudo en shell.
- No persistir nada en memoria.
