- Дата публикации
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:
- Добавить маркетплейс:
claude plugin marketplace add simple10/agents-observe - Поставить плагин:
claude plugin install agents-observe - Перезапустить 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-паттерны.
Для самостоятельного развёртывания без плагина:
-
Клонировать репозиторий и поднять Docker:
git clone https://github.com/simple10/agents-observe.git agents-observe cd agents-observe brew install just # при необходимости just start # запуск контейнераДля локальной разработки есть
just installиjust dev. -
Настроить хуки 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-подхода, это один из немногих инструментов, который даёт детальный, живой взгляд на то, что агенты реально делают, а не только что они пишут в ответах.