클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Claude Code 히스토리 파일 탐색기

Claude Code(및 Codex) 세션 기록을 전부 뒤져 원하는 대화를 찾고 삭제된 파일까지 원본 바이트로 복구해주는 스킬.

유틸리티중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

~/.claude/projects 아래에 쌓이는 JSONL 세션 기록을 체계적으로 검색·복구합니다.

  • 누락 없는 검색: 기본 홈(~/.claude)뿐 아니라 프로필별 홈(~/.claude-profiles/*), CLAUDE_CONFIG_DIR, 그리고 ~/.claude/history-sources.json에 등록된 장기 아카이브까지 한 번에 훑습니다. 프로젝트를 모르면 --all-projects, Codex 기록까지 보려면 --codex.
  • 정확한 파일 복구: file-history 스냅샷에서 캡처된 바이트 그대로 복원합니다. Write 이후의 Edit·셸 변경, 바이너리 파일도 대상이며, 스냅샷이 없으면 Write 시점 내용을 '낮은 정합성'으로 표시합니다.
  • 세션 분석과 트리아지: 메시지/툴 사용량 통계, 사용자가 실제로 입력한 문장만 추출한 HTML 리포트, 그리고 재부팅·크래시로 끊긴 세션을 done / stuck_no_result / interrupted_explicit 등으로 분류하는 triage 기능.

이런 분께 추천

  • 며칠 전 Claude와 나눈 대화에서 코드 조각이나 결정 사항을 다시 찾아야 하는 분
  • 실수로 지운 파일을 세션 기록에서 되살리고 싶은 분
  • 여러 모델 프로필이나 Codex를 병행해 기록이 여러 곳으로 흩어진 분
  • 크래시로 중단된 작업 목록을 정리해 이어가고 싶은 팀

활용 예시

  1. 프로젝트를 모를 때 문구로 찾기
    python3 scripts/analyze_sessions.py search --all-projects '리팩터링 계획' → 모든 프로젝트를 한 번에 훑고, 방금 입력한 문장 때문에 현재 세션이 1위로 나오면 --exclude-session <id>로 제외.
  2. 삭제된 컴포넌트 복구
    검색으로 세션 경로를 찾은 뒤 python3 scripts/recover_content.py <session.jsonl> -k ImportantFile -o ./recovered_ui/ → recovery_report.txt의 SHA-256으로 원본 일치 확인.
  3. 크래시 이후 밀린 작업 점검
    python3 scripts/analyze_sessions.py triage --all-projects --kind stuck_no_result → 마지막 어시스턴트 응답 전문을 읽고 이어서 진행할 세션 선별.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/claude-code-history-files-finder 폴더를 내 ~/.claude/skills/claude-code-history-files-finder/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills && mkdir -p ~/.claude/skills && cp -r /tmp/daymade-skills/daymade-claude-code/claude-code-history-files-finder ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 스킬을 저장할 폴더를 준비합니다: mkdir -p ~/.claude/skills
  2. 저장소를 임시 폴더로 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills
  3. 이 스킬 폴더만 복사합니다: cp -r /tmp/daymade-skills/daymade-claude-code/claude-code-history-files-finder ~/.claude/skills/
  4. Python 3가 설치돼 있는지 확인합니다: python3 --version (3.9 이상 권장)
  5. Claude Code를 새로 실행한 뒤 "예전 대화에서 ○○ 찾아줘" 처럼 요청하면 스킬이 자동으로 활성화됩니다.
  6. (선택) 오래된 기록을 따로 백업해 두었다면 ~/.claude/history-sources.json에 아카이브 경로를 등록해 기본 검색 범위에 포함시키세요.
  7. 잘 동작하는지 확인: python3 ~/.claude/skills/claude-code-history-files-finder/scripts/analyze_sessions.py list /작업/프로젝트/절대경로
GitHub에서 원본 보기 ↗라이선스: MIT