Claude Code 세션 요약 및 리플레이 도구 claudectl 공개

커뮤니티 반응

대체로 긍정적이며, Claude Code의 긴 로그를 읽는 데 지친 사용자들이 리플레이 기능의 효율성에 큰 관심을 보였다.

주요 논점

01찬성다수

에이전트의 작업 과정을 요약된 리플레이로 보는 것이 코드 리뷰 효율을 극대화한다.

합의점 vs 논쟁점

합의점

에이전트가 수행한 수천 줄의 로그를 그대로 읽는 것은 비효율적이다.
구조화된 로그 파싱 방식이 단순 비디오 녹화보다 기술적으로 우월하다.

실용적 조언

Claude Code 세션을 시각적으로 공유하거나 검토하고 싶다면 claudectl의 리플레이 기능을 활용하라.
GIF 출력을 원한다면 시스템에 agg를 미리 설치해두어야 한다.

섹션별 상세

Claude Code가 생성하는 대규모 작업 로그의 가독성 문제를 해결하기 위해 세션 리플레이 모드를 도입했다. 40분 분량의 세션을 약 25초의 요약 리플레이로 압축하며, 단순한 화면 녹화가 아닌 JSONL 대화 로그를 파싱하여 구조화된 프레임을 생성하는 방식으로 작동한다. 이를 통해 불필요한 대기 시간이나 에이전트의 부연 설명을 제거하고 핵심적인 변화만 포착할 수 있다.

리플레이 시스템은 파일 수정 내역, Bash 명령어 및 출력 결과, 발생한 오류, Claude의 간략한 계획 문구만을 선별적으로 추출한다. 추출된 데이터는 색상 구분이 적용된 Diff 형태로 표시되어 추가되거나 삭제된 코드를 한눈에 파악할 수 있게 설계됐다. 사용자는 대량의 JSONL 텍스트를 직접 읽지 않고도 에이전트가 수행한 작업을 시각적으로 검증할 수 있다.

결과물은 asciicast 파일 또는 GIF 형식으로 저장되어 대시보드에서 간편하게 확인할 수 있다. agg 도구가 설치된 환경에서는 GIF 변환을 지원하며, 모든 세션은 요약 카드 형태로 정리되어 관리 효율을 높인다. 이 도구는 MIT 라이선스로 GitHub에 공개되어 누구나 자유롭게 사용하고 기여할 수 있는 상태이다.

용어 해설

JSON 라인(JSONL): — 각 줄이 유효한 JSON 객체인 텍스트 파일 형식이다. 대규모 대화 로그나 데이터셋을 한 줄씩 독립적으로 처리할 수 있어 스트리밍 데이터 저장 및 분석에 효율적이다.
아스키캐스트(Asciicast): — 터미널 세션을 텍스트 기반으로 기록하는 파일 형식이다. 비디오 파일보다 용량이 매우 작으며, 텍스트를 복사하거나 재생 속도를 조절할 수 있는 터미널 녹화 표준이다.
세션 리플레이(Session Replay): — 사용자나 에이전트의 작업 과정을 그대로 다시 보여주는 기술이다. 이 도구에서는 Claude Code의 복잡한 작업 과정을 핵심 요약 정보 위주로 시각화하여 검토 효율을 높인다.

언급된 도구

claudectl추천링크

Claude Code 세션 관리 및 리플레이 시각화 도구

agg중립

asciicast 파일을 GIF로 변환하는 도구

언급된 리소스

GitHubclaudectl GitHub Repository