furkankly/zoetrope

What it solves

Zoetrope는 AI 에이전트 세션을 모니터링하고 검토할 수 있는 시각적인 방법을 제공합니다. Claude Code 또는 Codex와 같은 도구의 길고 선형적인 텍스트 트랜스크립트를 읽는 대신, 사용자는 전체 프로세스를 라이브 대화형 플로우 그래프로 볼 수 있습니다. 이를 통해 메인 에이전트와 그가 생성한 서브 에이전트 간의 관계, 그리고 실행되는 도구 호출 시퀀스를 더 쉽게 이해할 수 있습니다.

How it works

Zoetrope는 AI 에이전트가 생성하는 내부 트랜스크립트 파일 (JSONL)을 읽습니다. 이 트랜스크립트들을 추가 전용 이벤트 로그로 취급하여 에이전트, 프롬프트, 도구 호출 모델로 파싱합니다.

데이터를 보는 두 가지 방법을 제공합니다:

• Terminal UI: Rust와 Ratatui로 구축된 네이티브 바이너리로, 터미널에서 그래프를 렌더링합니다.
• Browser: 동일한 엔진의 WebAssembly (WASM) 버전으로, 사용자가 트랜스크립트 파일을 브라우저 창에 직접 드롭할 수 있습니다.

이 시스템은 별도의 "content clock" (세션 타임스탬프 기반)과 "presentation clock" (애니메이션용)을 사용하므로, 사용자가 세션 기록을 스크러빙하거나, 일시 중지하거나, 실행 중인 세션의 라이브 엣지를 실시간으로 따라갈 수 있습니다.

Who it’s for

Claude Code 및 Codex의 개발자와 파워 유저로, 에이전트 워크플로우에 대한 고수준의 시각적 개요를 원하며, 세션 실행을 "타임 트래블"하여 살펴보고, 각 에이전트의 동작 뒤에 있는 특정 프롬프트와 추론 과정을 검사할 수 있는 기능을 원하는 사용자입니다.

Highlights

• Live Flow Graph: 메인 에이전트와 생성된 서브 에이전트를 실시간 상태 및 도구 활동이 표시되는 노드로 시각화합니다.
• Time Travel: 스크러빙이 가능한 타임라인을 통해 사용자가 앞뒤로 탐색하며 세션이 특정 시점에 어떤 상태였는지 정확히 확인할 수 있습니다.
• Detailed Inspection: 에이전트를 클릭하면 생성 프롬프트, 추론, 그리고 타이밍이 포함된 특정 도구 호출 내역을 확인할 수 있습니다.
• Local-First & Private: 네트워크 의존성 없이 로컬 머신에서 완전히 작동하므로 트랜스크립트가 업로드되지 않습니다.
• Portable Core: 터미널과 브라우저 인터페이스를 모두 구동하는 Rust로 작성된 단일 엔진입니다.