History Insight

History Insight

Claude Code 세션 히스토리를 분석하고 인사이트를 추출합니다.

---

Data Location

~/.claude/projects/<encoded-cwd>/*.jsonl

Path Encoding: /Users/foo/project → -Users-foo-project

상세 파일 포맷: ${baseDir}/references/session-file-format.md

---

Execution Algorithm

Step 1: Ask Scope [MANDATORY]

스코프 결정:

1. 명시된 경우 (AskUserQuestion 생략 가능):

• "현재 프로젝트만" / "이 프로젝트" → current_project
• "모든 세션" / "전체" → all_sessions

2. 명시되지 않은 경우 - AskUserQuestion 호출:

   question: "세션 검색 범위를 선택하세요"
   options:
     - "현재 프로젝트만" → ~/.claude/projects/<encoded-cwd>/*.jsonl
     - "모든 Claude Code 세션" → ~/.claude/projects/**/*.jsonl

---

Step 2: Find Session Files

# Current project only
find ~/.claude/projects/<encoded-cwd> -name "*.jsonl" -type f

# All sessions (모든 프로젝트)
find ~/.claude/projects -name "*.jsonl" -type f

날짜 필터링: 파일의 mtime(수정시간) 확인 후 필터. OS별 stat 옵션 다름:

• macOS: stat -f "%Sm" -t "%Y-%m-%d" <file>
• Linux: stat -c "%y" <file>

---

Step 3: Process Sessions

Decision Tree

Session files found?
├─ No → Error: "No sessions found"
└─ Yes → How many files?
    ├─ 1-3 files → Direct Read + parse
    └─ 4+ files → Batch Extract Pipeline

1-3 Files

직접 Read로 JSONL 파싱. 파일이 크면(≥5000 tokens) extract-session.sh 사용:

${baseDir}/scripts/extract-session.sh <session.jsonl>

4+ Files: Batch Extract Pipeline

1. 캐시 디렉토리 생성 (/tmp/cc-cache/<analysis-name>/) 2. 세션 목록 저장 (sessions.txt) 3. jq로 메시지 일괄 추출 (user_messages.txt) 4. 정리 및 필터링 (clean_messages.txt) 5. Task(opus)로 종합 분석

파일이 너무 클 때: 병렬 배치 분석

clean_messages.txt가 너무 커서 Read 실패 시:

1. 파일 분할:

   split -l 2000 clean_messages.txt /tmp/cc-cache/<name>/batch_

2. 병렬 Task(opus) 호출:

   Task(subagent_type="general-purpose", model="opus", run_in_background=true)
   prompt: "batch_XX 파일을 읽고 주제/패턴 요약해줘"

3. 결과 병합: Task(opus)로 종합

---

Step 4: Report Results

## Session Capture Complete

- **Sessions:** N files processed
- **Messages:** X total, Y after filter

### Extracted Insights
[분석 결과]

---

Error Handling

---

Security Notes

• 출력에 전체 경로 노출 금지 (~ prefix 사용)

---

Related Resources

• `${baseDir}/scripts/extract-session.sh` - JSONL 압축 (thinking, tool_use 제거)
• `${baseDir}/references/session-file-format.md` - JSONL 구조 및 파싱

Session File Format (.jsonl)

Claude Code 세션 파일의 상세 구조 및 파싱 방법

JSONL Type 분류

실제 분석 결과 (12MB 파일 예시)

결론: 실제 대화는 6%, 나머지 94%는 메타데이터

assistant 메시지 내부 구조

.message.content[] 배열 내부:

JSON 파싱 명령어

user 메시지 추출:

jq -c 'select(.type == "user") | {type, content: .message.content, ts: .timestamp}' <file.jsonl>

assistant 메시지 추출 (text만):

jq -c 'select(.type == "assistant") | {type, texts: [.message.content[] | select(.type == "text") | .text], ts: .timestamp}' <file.jsonl>

한 번에 대화만 추출:

jq -c '
  if .type == "user" then
    {type: "user", content: .message.content, ts: .timestamp}
  elif .type == "assistant" then
    {type: "assistant", texts: [.message.content[]? | select(.type == "text") | .text], ts: .timestamp}
    | select(.texts | length > 0)
  else empty end
' <file.jsonl>

결과: 12MB → ~160KB (99% 감소)