Агенты наблюдают: Панель мониторинга в реальном времени для команд агентов Claude Code

Что делает Agents Observe

Agents Observe — это панель мониторинга в реальном времени, специально созданная для команд агентов Claude Code. Она решает проблему отсутствия видимости, когда Claude Code работает автономно — создавая подчинённых агентов, вызывая инструменты, читая файлы и выполняя команды — путём захвата каждого события хука по мере его возникновения и потоковой передачи на живую панель мониторинга.

Ключевые возможности и архитектура

Инструмент использует хуки Claude Code вместо OTEL (OpenTelemetry) для захвата того, что разработчик описывает как «полную картину действий агента». Архитектура следует такому потоку:

• Хуки Claude Code → observe_cli.mjs → API-сервер (SQLite) → React-панель
• Скрипт хука читает сырые события из stdin, добавляет имя проекта и отправляет их POST-запросом на сервер
• Сервер парсит события, сохраняет метаданные агента (имя, тип, родительские связи) и пересылает события клиентам WebSocket
• React-панель выводит всё состояние агента из потока событий

С помощью панели вы можете:

• Наблюдать, как вызовы инструментов поступают в потоке по мере их выполнения (PreToolUse → PostToolUse с результатами)
• Видеть полную иерархию агентов — какой подчинённый агент был создан каким родителем
• Фильтровать по агенту, типу инструмента или искать по всем событиям
• Развернуть любое событие, чтобы увидеть полный набор данных, команду и результат
• Нажимать на иконки временной шкалы, чтобы перейти к конкретным событиям в потоке
• Просматривать исторические сессии с понятными человеку именами (например, «twinkly-hugging-dragon»)

Установка и настройка

Предварительные требования:

• Docker (обязательно — сервер работает как контейнер)
• Node.js (обязательно — скрипты хуков запускаются через node)

Шаги установки плагина:

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

После перезапуска Claude Code сервер автоматически запускается как контейнер Docker при следующей сессии, и хуки начинают захватывать события. Панель доступна по адресу http://localhost:4981.

Возможности плагина

• /observe — Открыть URL панели и проверить, работает ли сервер
• /observe status — Проверить состояние сервера и показать URL панели

Идеи по производительности от разработки

Разработчик поделился несколькими техническими выводами, полученными при создании и использовании инструмента:

• Хуки Claude Code блокирующие — производительность быстро снижается при использовании многих плагинов, применяющих хуки
• Хуки предоставляют более полезную информацию, чем данные OTEL
• Файлы jsonl Claude дают полную картину
• Управление жизненным циклом процессов MCP, запускаемых плагинами, «в лучшем случае немного неуклюже»
• Переход на фоновые (запустил и забыл) хуки и удаление других плагинов значительно улучшили производительность Claude

Разработчик реализовал решение по управлению процессами, при котором сервер отслеживает активные подключения и автоматически завершает работу, когда не используется, после чего плагин снова запускает его при начале новой сессии. Этот подход на основе Docker отмечен как шаблон, который может повысить безопасность за счёт изоляции сервисов.