claude-chronicle

Git-like conversation history manager for Claude Code.

세션을 자동 캡처하고, 대화 이력을 git log처럼 조회하며, 브라우저 GUI로 시각화합니다.

Install

npm install -g claude-chronicle

Quick Start

# 1. 초기화 (Claude Code hook 자동 설정)
chronicle init

# 2. 기존 대화 가져오기
chronicle import

# 3. 대화 이력 조회
chronicle log

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

Commands

| 명령어 | 설명 | |--------|------| | 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 status | Chronicle 상태 확인 | | chronicle gui | 브라우저 GUI 대시보드 | | chronicle export <id> | 작업 산출물 MD 파일 내보내기 | | chronicle delete <id> | 세션 삭제 | | chronicle summarize [id] | AI 요약 업그레이드 |

Log Filters

# 프로젝트 필터
chronicle log -p myproject

# 브랜치 필터
chronicle log -b feature/auth

# 날짜 필터
chronicle log --since 7d          # 최근 7일
chronicle log --since 2w          # 최근 2주
chronicle log --since 2025-01-01  # 특정 날짜 이후
chronicle log --since today       # 오늘
chronicle log --until 2025-06-30  # 특정 날짜까지

GUI Dashboard

chronicle gui              # http://localhost:3300
chronicle gui --port 8080  # 포트 지정

타임라인 뷰, 프로젝트 필터, 코드 diff 확인, 키워드 검색, MD 내보내기를 브라우저에서 할 수 있습니다.

How It Works

1. chronicle init이 Claude Code의 SessionEnd hook을 설정합니다
2. Claude Code 세션이 끝날 때마다 자동으로 대화를 캡처합니다
3. ~/.claude/projects/의 JSONL 데이터를 파싱하여 ~/.chronicle/에 저장합니다
4. 원본 데이터는 수정하지 않습니다 (읽기 전용)

Data Safety

• Claude Code 원본 데이터를 절대 수정하지 않습니다
• 독립 저장소(~/.chronicle/)에 별도 저장
• hook이 실패해도 Claude Code 세션에 영향 없음
• 시스템 권한 변경 없음

Requirements

• Node.js >= 18
• Claude Code (대화 데이터 원본)

License

MIT