Agentes Observan: Panel en Tiempo Real para Monitorear Equipos de Agentes de Código Claude

Qué hace Agents Observe

Agents Observe es un panel de control de observabilidad en tiempo real específicamente construido para equipos de agentes Claude Code. Aborda la brecha de visibilidad cuando Claude Code se ejecuta de forma autónoma—generando subagentes, llamando herramientas, leyendo archivos y ejecutando comandos—capturando cada evento de hook a medida que ocurre y transmitiéndolo a un panel de control en vivo.

Características clave y arquitectura

La herramienta utiliza hooks de Claude Code en lugar de OTEL (OpenTelemetry) para capturar lo que el desarrollador describe como "la imagen completa de las acciones del agente". La arquitectura sigue este flujo:

• Claude Code Hooks → observe_cli.mjs → Servidor API (SQLite) → Panel de control React
• El script de hook lee eventos sin procesar desde stdin, agrega el nombre del proyecto y los envía mediante POST al servidor
• El servidor analiza eventos, almacena metadatos del agente (nombre, tipo, parentesco) y reenvía eventos a clientes WebSocket
• El panel de control React deriva todo el estado del agente del flujo de eventos

Con el panel de control, puedes:

• Ver las llamadas a herramientas transmitirse a medida que ocurren (PreToolUse → PostToolUse con resultados)
• Ver la jerarquía completa del agente—qué subagente fue generado por qué padre
• Filtrar por agente, tipo de herramienta o buscar en todos los eventos
• Expandir cualquier evento para ver la carga completa, comando y resultado
• Hacer clic en los iconos de la línea de tiempo para saltar a eventos específicos en el flujo
• Navegar por sesiones históricas con nombres legibles para humanos (ej. "twinkly-hugging-dragon")

Instalación y configuración

Requisitos previos:

• Docker (requerido—el servidor se ejecuta como contenedor)
• Node.js (requerido—los scripts de hook se ejecutan mediante node)

Pasos de instalación del plugin:

claude plugin marketplace add simple10/agents-observe
claude plugin install agents-observe

Después de reiniciar Claude Code, el servidor se inicia automáticamente como un contenedor Docker en tu próxima sesión, y los hooks comienzan a capturar eventos. El panel de control está disponible en http://localhost:4981.

Habilidades del plugin

• /observe — Abre la URL del panel de control y verifica si el servidor está ejecutándose
• /observe status — Verifica la salud del servidor y muestra la URL del panel de control

Perspectivas de rendimiento del desarrollo

El desarrollador compartió varios aprendizajes técnicos de construir y usar la herramienta:

• Los hooks de Claude Code son bloqueantes—el rendimiento se degrada rápidamente con muchos plugins que usan hooks
• Los hooks proporcionan información más útil que los datos OTEL
• Los archivos jsonl de Claude proporcionan la imagen completa
• La gestión del ciclo de vida de los procesos MCP iniciados por plugins es "un poco torpe en el mejor de los casos"
• Cambiar a hooks en segundo plano (disparar y olvidar) y eliminar otros plugins mejoró significativamente el rendimiento de Claude

El desarrollador implementó una solución de gestión de procesos donde el servidor rastrea conexiones activas y se apaga automáticamente cuando no está en uso, luego el plugin lo reactiva cuando comienza una nueva sesión. Este enfoque basado en Docker se señala como un patrón que podría mejorar la seguridad aislando servicios.