furkankly/zoetrope

어떤 프로젝트인가요?

핵심 기능

• 01각 에이전트와 하위 에이전트, 워크플로 그룹을 상태 및 도구 호출 수와 함께 노드로 표시합니다.
• 02도구 호출을 해당 에이전트 아래에 칩으로 표시하고 성공 또는 실패 여부를 나타냅니다.
• 03완료된 세션을 재생하거나 실시간 세션을 따라가며, 원하는 위치로 이동할 수 있는 타임라인을 제공합니다.
• 04이전 시점으로 이동하면 해당 순간의 세션 상태를 정확히 복원합니다.
• 05에이전트를 클릭하면 에이전트를 생성한 프롬프트, 모델, 도구 호출 및 각 호출의 소요 시간을 확인할 수 있습니다.
• 06터미널이나 브라우저에서 실행할 수 있으며, 헤드리스 inspect 모드도 지원합니다.

활용 사례

• 장시간 실행되는 Claude Code 또는 Codex 세션을 지켜보며 어떤 하위 에이전트가 활성화되어 있는지 확인합니다.
• 완료된 에이전트 실행을 검토해 작업이 어떻게 위임되었고 어떤 도구가 사용되었는지 파악합니다.
• 시점별로 기록을 살펴보며 에이전트 워크플로를 디버깅합니다.
• TTY가 없는 머신에서 헤드리스 명령으로 세션을 확인합니다.

빠른 시작

1. 1

   Homebrew로 설치

   brew install furkankly/tap/zoetrope
2. 2

   또는 Cargo로 설치

   cargo install zoetrope
3. 3

   실행하여 현재 프로젝트의 라이브 세션 추적

   zoe

사용 전 알아둘 점

• !문서화되지 않은 Claude Code 및 Codex 트랜스크립트 형식에 의존하며, 예고 없이 변경될 수 있습니다.
• !읽기 전용 뷰어입니다. 에이전트 세션을 제어하거나 실행하지 않습니다.

토픽

자주 묻는 질문

zoetrope은(는) 무엇인가요?

Claude Code와 Codex 세션을 에이전트와 도구 호출의 실시간 흐름 그래프로 보여주는 터미널·브라우저 뷰어입니다. zoetrope는 Claude Code와 Codex가 각 세션에 대해 작성하는 transcript 파일을 읽어 세션을 그래프로 표시합니다. 메인 에이전트와 메인 에이전트가 생성한 하위 에이전트, 각 에이전트가 실행하는 도구를 확인할 수 있습니다. 세션이 진행되면 그래프도 업데이트됩니다. 완료된 세션은 설정 가능한 속도로 재생할 수 있으며, 재생 속도는 세션 자체의 타임스탬프에 맞춰집니다. 실행 중인 세션을 따라가며 그래프가 확장되는 모습도 볼 수 있습니다.

zoetrope은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

zoetrope은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

zoetrope은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. zoetrope의 마지막 커밋은 2026년 10월 14일입니다.

zoetrope은(는) 어디에 사용할 수 있나요?

장시간 실행되는 Claude Code 또는 Codex 세션을 지켜보며 어떤 하위 에이전트가 활성화되어 있는지 확인합니다. 완료된 에이전트 실행을 검토해 작업이 어떻게 위임되었고 어떤 도구가 사용되었는지 파악합니다. 시점별로 기록을 살펴보며 에이전트 워크플로를 디버깅합니다. TTY가 없는 머신에서 헤드리스 명령으로 세션을 확인합니다.

zoetrope는 어떻게 설치하나요?

Homebrew로 설치: brew install furkankly/tap/zoetrope 또는 Cargo로 설치: cargo install zoetrope 실행하여 현재 프로젝트의 라이브 세션 추적: zoe

zoetrope은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/furkankly/zoetrope