← AI Projects
CLI Tool

Chronicle

Claude Code 대화 이력을 Git처럼 관리하는 CLI 도구

세션을 자동 캡처하고, 대화 이력을 git log처럼 조회하며, 브라우저 GUI로 시각화합니다.
claude clear로 대화를 지워도 기록은 안전하게 보존됩니다.

Quick Start

1

설치

npm install -g claude-chronicle
2

초기화 (Claude Code hook 자동 설정)

chronicle init
3

기존 대화 가져오기

chronicle import
4

대화 이력 조회

chronicle log

이후부터는 Claude Code 세션이 종료될 때마다 자동으로 기록됩니다.

주요 기능

🕐

자동 캡처

대화가 끝나면 자동으로 기록됩니다. 별도 조작이 필요 없습니다.

🛡️

안전한 저장

claude clear로 대화를 지워도 기록은 보존됩니다. 원본 데이터는 수정하지 않습니다.

Git 스타일

log, show, diff, branches 등 익숙한 Git 명령어로 조회합니다.

🖥️

GUI 대시보드

브라우저에서 타임라인 뷰로 세션을 시각적으로 탐색할 수 있습니다.

📄

산출물 내보내기

세션을 Markdown 보고서로 변환합니다. AI 요약도 지원합니다.

🔍

키워드 검색

모든 대화 내용을 키워드로 빠르게 검색할 수 있습니다.

어떻게 동작하나요?

1
chronicle init이 Claude Code의 SessionEnd hook을 설정합니다
2
Claude Code 세션이 끝날 때마다 자동으로 대화를 캡처합니다
3
JSONL 데이터를 파싱하여 ~/.chronicle/에 독립 저장합니다

명령어 모음

명령어 설명
chronicle init초기화 및 Claude Code hook 설정
chronicle import기존 Claude Code 대화 일괄 가져오기
chronicle log대화 이력 조회 (git log 스타일)
chronicle show <id>세션 상세 조회
chronicle diff <id>코드 변경 내용 확인
chronicle search <keyword>대화 내용 키워드 검색
chronicle branches세션 목록
chronicle stats프로젝트별 통계
chronicle gui브라우저 GUI 대시보드
chronicle export <id>작업 산출물 MD 파일 내보내기
chronicle summarize [id]AI 요약 업그레이드

Log 필터

프로젝트 필터

chronicle log -p myproject

브랜치 필터

chronicle log -b feature/auth

최근 N일

chronicle log --since 7d

특정 날짜 이후

chronicle log --since 2025-01-01