Дата публикации
ai_products

Agents Observe: живой дашборд для команд Claude Code-агентов в реальном времени

Что появилось / что изменилось

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

Главные новшества:

  • Живой дашборд для многокомпонентных сессий Claude Code: видно, какие агенты запущены, какие инструменты вызывают, какие файлы трогают.
  • Полная трассировка multi-agent-сессий: видно иерархию агентов — кто кого создал и что каждый делает.
  • Фильтры и поиск: можно отфильтровать события по агенту, типу инструмента или искать по всей истории.
  • Детальный просмотр событий: каждое событие можно раскрыть и увидеть полный payload, команду и результат.
  • Исторические сессии: дашборд хранит прошлые сессии с читаемыми именами вроде "twinkly-hugging-dragon".
  • Локальный или удалённый сервер: всё крутится в Docker-контейнере, к которому могут логироваться несколько экземпляров Claude Code.
  • Плагин для Claude Code с командами:
    • /observe — открыть дашборд и проверить, запущен ли сервер;
    • /observe status — показать статус сервера и URL дашборда.

Установка через маркетплейс Claude Code:

  1. Добавить маркетплейс:
    claude plugin marketplace add simple10/agents-observe
    
  2. Поставить плагин:
    claude plugin install agents-observe
    
  3. Перезапустить Claude Code.

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

Как это работает

Архитектура довольно прозрачная:

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

Важный момент: разработчик сознательно использует хуки вместо OTEL, чтобы логировать полный контекст действий агентов, а не урезанный телеметрию. В потоке видно переходы PreToolUse → PostToolUse с результатами, команды Bash, чтение и правки файлов, grep-паттерны.

Для самостоятельного развёртывания без плагина:

  1. Клонировать репозиторий и поднять Docker:

    git clone https://github.com/simple10/agents-observe.git agents-observe
    cd agents-observe
    brew install just # при необходимости
    just start        # запуск контейнера
    

    Для локальной разработки есть just install и just dev.

  2. Настроить хуки Claude Code:

    just setup-hooks my-project
    

    Команда печатает JSON с уже проставленными путями. Этот фрагмент нужно вставить в настройки Claude Code:

    • на уровне проекта: .claude/settings.json в корне;
    • либо глобально: ~/.claude/settings.json.

Что это значит для вас

Если вы запускаете Claude Code в автономном режиме, особенно с несколькими агентами, Agents Observe решает главную проблему: вы наконец видите, что происходит под капотом.

Где это полезно:

  • Разработка с автогенерацией кода. Координатор создаёт ревьюера, тест-раннер и документационный агент. Обычно вы видите только финальный текст. С дашбордом вы наблюдаете, как каждый агент читает файлы, правит код и гоняет тесты, и можете остановить странные действия до того, как они что-то сломают.
  • Отладка «заглючивших» агентов. Если подагент сделал неудачную правку или запустил опасную команду, есть точная временная шкала: какие события шли до этого, какие команды выполнялись, какие файлы менялись.
  • Аналитика по сессиям. Можно смотреть, какие инструменты агенты чаще используют, где они регулярно застревают и как меняется поведение в разных проектах.

Где продукт менее уместен:

  • Если вы используете Claude Code только как «умный терминал» с одним агентом и короткими сессиями, выгода от отдельного дашборда будет небольшой.
  • Если вы не готовы поднимать Docker и трогать настройки .claude/settings.json, установка может показаться излишней.

Важно: сервер и дашборд работают локально или на вашем удалённом сервере. Никакого SaaS по умолчанию, но для работы нужен Docker и Node.js. Если доступ к Docker ограничен (жёсткие корпоративные политики), придётся договариваться с админами.

Для России: продукт распространяется через GitHub и плагин-маркетплейс Claude Code. Если у вас уже есть доступ к Claude Code и GitHub, дополнительных VPN-требований сам по себе Agents Observe не добавляет.

Место на рынке

Agents Observe нацелен на довольно узкий сценарий: наблюдаемость за Claude Code-агентами. Он не конкурирует напрямую с GPT-ориентированными IDE-плагинами или классическими APM/лог-решениями.

Ключевые отличия от типичных инструментов логирования и телеметрии:

  • Вместо OTEL и абстрактных метрик здесь сырые события агентов с полными payload’ами и иерархией подагентов.
  • Дашборд показывает структуру multi-agent-сессий, а не просто ленту логов.
  • Установка завязана именно на экосистему Claude Code: хуки, плагин-маркетплейс, специальные команды /observe.

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


Читайте также