pi-subagents

Defines tus tipos de agente en .pi/agents/<nombre>.md (o a nivel global), con frontmatter YAML para el system prompt, el modelo, el nivel de thinking y qué tools puede usar. Desde el prompt los lanzas en segundo plano —es el comportamiento por defecto— o bloqueas hasta que terminen; con @explore revisa la ruta RPC el mensaje va a ese agente y no entra en el chat principal. Hasta 10 concurrentes por defecto, con cola automática.

El widget persistente encima del editor muestra spinners, actividad de tools, recuento de tokens e iconos de estado. Con FleetView navegas la sesión main y cada subagente: flechas para seleccionar, Enter para abrir la conversación en vivo y Esc para volver. Si se desvía, abres el compositor en el visor, escribes y lo rediriges tras su tool actual; con x lo paras (pide confirmación). Los agentes terminados se pueden reanudar, y @main fuerza el texto otra vez al modelo principal.

Orquestación con script cuando no quieres improvisar

El tool SubagentWorkflow ejecuta JavaScript determinista: agent(), parallel(), pipeline(), phase() y log(). Un pipeline no pone barrera entre etapas, así un ítem puede ir por delante mientras otro sigue en la primera; parallel espera al más lento. Puedes poner gate: "npm test" en el worktree del hijo o resume para no volver a pagar el contexto. Los scripts del tool Workflow de Claude Code corren aquí sin cambios. Si activas subagentes anidados, un tipo con allowed_subagents obtiene sus propias tools de spawn, con tope de profundidad (2 por defecto) y el gasto de tokens se acumula en el padre.