simple10/agents-observe

해결하는 문제

AI 에이전트(예: Claude Code)가 자율적으로 실행될 때, 서브에이전트 생성, bash 명령 실행, 파일 읽기와 같은 내부 프로세스는 사용자에게 보이지 않는 경우가 많습니다. 이러한 투명성 부족으로 인해 에이전트가 실시간으로 무엇을 하는지 이해하거나 병렬 실행 체인의 깊은 곳에서 발생한 오류를 디버깅하는 것이 어렵습니다.

작동 방식

Agents Observe는 에이전트 이벤트(도구 호출, 프롬프트, 서브에이전트 생명주기 등)마다 트리거되는 훅 시스템을 사용합니다. CLI 도구가 이러한 이벤트를 캡처하고 HTTP POST로 백엔드 서버(도커에서 실행 중)로 전송합니다. 백엔드 서버는 SQLite 데이터베이스에 이벤트를 저장합니다. React 기반 대시보드는 WebSocket을 통해 실시간으로 이벤트를 스트리밍하여 사용자가 에이전트 계층 구조, 도구 사용 현황, 세션 기록을 시각화할 수 있도록 합니다.

대상 사용자

자율적인 AI 에이전트의 행동을 깊이 있게 가시화하여 디버깅, 모니터링, 분석이 필요한 Claude Code 또는 Codex 에이전트를 사용하는 개발자들.

주요 기능

• 실시간 모니터링: 도구 호출과 에이전트 활동이 실시간으로 대시보드에 스트리밍됩니다.
• 에이전트 계층 구조 시각화: 어떤 부모 에이전트가 어떤 서브에이전트를 생성했는지 정확히 확인할 수 있습니다.
• 토큰 및 비용 추적: 각 세션의 토큰 사용량과 비용 내역을 모니터링할 수 있습니다.
• 전체 이벤트 재생: 과거 세션을 전체 페이로드, 명령어, 결과와 함께 탐색하여 '시간 여행' 디버깅이 가능합니다.
• 통합 플러그인: Claude Code 플러그인으로 직접 설치 가능하며, 전용 슬래시 명령어(예: /observe status)를 통해 관리할 수 있습니다.