Agent Tree: el árbol de subagentes de Claude Code como cajas
Un panel lateral que dibuja los subagentes como cajas, con la sesión principal, el asesor y un registro de la sesión.
Permisos
- Intercepta llamadas a herramientasVe cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
- Lee tus promptsPuede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
- Modifica la interfazDibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
- Añade comandos/herramientasRegistra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
- probado con
- v2.1.310
- última prueba
- requiere
- Claude Code ≥ 2.1.287
- superficies
- panel, estado
- código fuente
- Mike Pollow, Digitalroots (MikeGT4) (MIT)
Instalar dentro de Claude Code:
/plugin install agent-tree --marketplace MikeGT4/agent-tree¿Qué hace este mod?
Agent Tree es un mod de la comunidad de Mike Pollow, Digitalroots (MikeGT4). Muestra el árbol de subagentes de Claude Code en un panel lateral, dibujado con cajas. Arriba está la sesión principal con su modelo, nivel de esfuerzo, uso de contexto y número de ronda. Debajo, cada subagente tiene una caja con el tipo, el modelo, la descripción, la última herramienta, una línea de estado y una barra de tiempo. Una última caja marca el camino de vuelta a la sesión principal y cuenta las respuestas devueltas.
Junto al árbol, una columna del asesor indica si hay un modelo asesor configurado, cuántas veces se le consultó, desde la sesión principal o desde subagentes, y cuándo fue la última vez. Abajo del todo, un registro de la sesión lista las rondas, los inicios y finales de agentes, las llamadas al asesor y tus propias elecciones. Cuando hay muchos agentes, el panel pasa a filas compactas, y un workflow con muchos agentes se pliega en una sola caja.
El panel también es una superficie de control. Haz clic en el tipo de un agente para ver su tarea, sus herramientas recientes y su última respuesta, y para detenerlo. Puedes elegir una familia de modelos para los subagentes nuevos o para un agente en ejecución. Solo en esos casos el mod cambia lo que hace Claude Code. La línea de estado también recibe un resumen breve como Sub-agents [1/1] · $0.00. El autor lo probó con Claude Code 2.1.296 y de 2.1.307 a 2.1.310.
Demo
La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración y ejecuta /agent-tree, que abre el panel: la sesión principal está inactiva, todavía no hay subagentes y el registro está vacío. Luego le pide a Claude que use un subagente para leer src/login.js y lo describa en una frase. El panel pasa a WORKING, el registro recibe una línea "Round 1" y aparece un subagente general-purpose en ejecución, con la sesión principal "esperando a los subagentes" y la cifra de contexto rellenándose. Cuando el agente termina, su respuesta se cuenta en la caja "back to main session".
Instalación
Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el marketplace del propio autor. Después, ejecuta /agent-tree para abrir el panel.
$ install agent-tree
Requiere Claude Code ≥ 2.1.287
Se instala desde el marketplace del autor: MikeGT4/agent-tree
1.Una línea, dentro de Claude Code
/plugin install agent-tree --marketplace MikeGT4/agent-treePégala en una sesión abierta (v2.1.275+). Claude Code te pedirá primero añadir el marketplace.
2.Desde tu shell
claude plugin marketplace add MikeGT4/agent-tree claude plugin install agent-tree@agent-treeDespués ejecuta /reload-plugins en cualquier sesión que ya esté abierta.
3.Pruébalo sin instalarlo
git clone https://github.com/MikeGT4/agent-tree claude --plugin-dir ./agent-treeCarga el mod solo para una sesión. No se añade nada a tu configuración.
Cómo funciona
El mod guarda el árbol en un átomo de estado y escucha los eventos de agentes: agent.spawn añade un nodo, tool.call cuenta herramientas, turn.step registra modelo, esfuerzo y uso del asesor, y turn.complete marca un agente como terminado, fallido o detenido. ui.render dibuja el panel a partir de ese estado. Un temporizador de 250 ms anima el indicador solo mientras un agente trabaja. La función de detener es la parte que bloquea llamadas a herramientas, de hooks/register.tsx:
if (stoppingIds.has(agentId)) {
if (e.tool !== HANDBACK) {
const current = await read($, tree)
return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
}Solo se ve afectado un agente que pediste detener. El texto que viene de la sesión (tarea, respuestas, etiquetas de herramientas) se limpia antes de dibujarse: se eliminan los escapes de terminal y los caracteres de control, y las cadenas que parecen tokens, contraseñas o pares KEY=value se sustituyen por •••. Las etiquetas de herramientas muestran un nombre de archivo, de programa o un host, no el comando completo.
Personalízalo
/config ofrece cinco opciones: ancho del panel acoplado (90 columnas por defecto, de 40 a 140), cuántos subagentes conserva el árbol (30 por defecto), abrir al iniciar (desactivado por defecto), movimiento (animación del indicador y del flujo, activado por defecto) e idioma (auto, de, en). Un ancho arrastrado a mano tiene prioridad. Teclas dentro del panel: m para elegir modelo, 0 a 4 para elegir, x para cerrar, s para detener en la vista de detalles y ctrl+x tab para enfocar el panel.
Permisos y seguridad
Leímos todos los archivos que el plugin puede ejecutar: hooks/hooks.json, register.tsx, model.ts, view.tsx, words.ts, las declaraciones de tipos, las pruebas, el README y PRIVACY.md. No hay package.json, script de instalación, binario ni código empaquetado. El único archivo que no es de texto es un icono PNG.
- Red, procesos, archivos, demonios, secretos: ninguno. No encontramos llamadas de red, comandos de shell, escritura de archivos, variables de entorno ni acceso a credenciales, y nada sigue ejecutándose cuando Claude Code se cierra. El temporizador se detiene cuando no hay agentes ocupados.
- Lee: la lista de agentes y los mensajes de los subagentes (para la vista de detalles), tus ajustes
languageyadvisorModel, y las cifras de contexto y coste. - Telemetría: ninguna.
- Hooks de control:
agent.spawnañade el modelo que elegiste a los subagentes nuevos que no indican ninguno,turn.stepcambia el siguiente paso de un agente en ejecución al modelo elegido o lo sustituye por un breve informe cuando pulsas detener, ytool.callrechaza más llamadas a herramientas de un agente detenido. Los tres actúan solo después de que hagas clic en el panel, lo que coincide con el README y PRIVACY.md. El informe de detención es un mensaje sintético del asistente que incluye una llamada a la herramientaSubagentHandbackcon un id aleatorio. - Inyección de prompts: no encontramos ninguna. El mod no añade texto a los prompts ni contiene Unicode oculto.
- Licencia: MIT, con archivo LICENSE.
claude plugin validate no informó de errores ni advertencias; señala que el directorio de plugins tiene reglas propias para los módulos de hooks que validate no aplica. Las 63 pruebas del autor pasaron con Claude Code 2.1.310.
- Intercepta llamadas a herramientas
- Ve cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
- Lee tus prompts
- Puede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
- Modifica la interfaz
- Dibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
- Añade comandos/herramientas
- Registra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
Compatibilidad y solución de problemas
Comprobado con Claude Code 2.1.310 en macOS (validate, pruebas y la grabación). Necesita la interfaz de mods. Si el panel no aparece:
claude --versiones 2.1.287 o posterior.- Ejecutaste
/agent-tree; el panel no se abre solo. Si funciona, el comando muestra "Agent Tree opened". - El terminal es lo bastante ancho: por debajo de 84 columnas la columna del asesor se apila sobre el árbol, y por debajo de 40 columnas de ancho de panel el diseño queda apretado.
- Los agentes iniciados antes de cargar el mod se recogen de la lista de agentes al abrir el panel.
- El panel no muestra nada en una sesión sin subagentes: dice "no sub-agents yet".
Preguntas frecuentes
- ¿Agent Tree envía datos o hace peticiones de red?
- No. El código no tiene llamadas de red y el PRIVACY.md del autor dice que nada sale del equipo. Guarda el árbol solo en memoria durante la sesión en curso y no escribe archivos.
- ¿Puedo detener un subagente en ejecución desde el panel?
- Sí. Haz clic en el tipo del agente para abrir sus detalles y pulsa detener (o la tecla s). Las siguientes llamadas a herramientas de ese agente se rechazan y su próximo paso devuelve un breve informe de "detenido por el usuario".
- ¿Puedo cambiar el modelo de un subagente?
- Sí. El botón Modelo fija la familia de modelos (Haiku, Sonnet, Opus o Fable) para los subagentes nuevos, y el botón de la caja de un agente en ejecución cambia sus próximos pasos. Un modelo que la propia llamada indique no se toca.
- ¿El panel está siempre abierto?
- No por defecto. /agent-tree lo abre, /agent-tree stop lo cierra y /agent-tree clear reinicia el árbol. El ajuste "Abrir al iniciar" lo abre en cada sesión.
- ¿Las etiquetas están en inglés?
- Por defecto siguen el ajuste de idioma, alemán o inglés. La opción Language puede forzar de o en. Las horas del registro se muestran en formato de 24 horas.
# Mods relacionados
DestacadoAgent Radar
Una línea en vivo sobre el prompt por subagente en ejecución: tiempo, herramientas y acción actual, más un panel /radar.
- sobre el prompt
- panel
- aviso
- Intercepta llamadas a herramientas
- Lee tus prompts
- Modifica la interfaz
- Añade comandos/herramientas
probado con v2.1.291
DestacadoAgent Profiler
Adónde va el tiempo de una sesión de Claude Code: modelo, herramientas, subagentes, en vivo. Con exportación OTLP.
- estado
- panel
- aviso
- Escribe archivos
- Red
- Intercepta llamadas a herramientas
- Modifica la interfaz
- Añade comandos/herramientas
probado con v2.1.303
Más en Paneles y dashboards, Temporizadores, tareas y standups.