로컬 대화 기록 조회
Claude Code와 OpenAI Codex의 로컬 대화 기록을 한 번의 읽기 전용 명령으로 목록화해 보여주는 스킬입니다.
유틸리티중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 현재 워크스페이스(프로젝트 폴더) 기준으로 최근 Claude Code / Codex 대화 목록을 한 번에 출력합니다.
~/.claude등 활성 설정 홈과~/.claude/history-sources.json에 등록된 장기 아카이브를 모두 훑고, 세션 ID 중복을 제거합니다.- 파일 수정 시각(mtime)이 아니라 JSONL 내부 타임스탬프를 기준으로 정렬·필터링하므로, 아카이브를 복사·이전해도 시간이 어긋나지 않습니다.
- 제목, 타임존이 명시된 시각, 출처(active/archive), 세션 ID, 아카이브·테스트 표시를 Markdown 또는 JSON으로 정리해 줍니다.
- 내부 서브에이전트 잡음은 기본적으로 제외하며, 필요할 때만
--include-subagents등으로 포함합니다.
이런 분께 추천
- 여러 프로젝트를 오가며 Claude Code를 쓰다가 "그 작업 어디서 했지?"를 자주 겪는 개발자.
- Claude Code와 Codex CLI를 병행 사용해 기록이 흩어져 있는 사용자.
- 대화 기록을 별도 디스크나 백업 폴더로 아카이브해두고도 통합 조회가 필요한 사용자.
- 이어서 작업할 세션 ID를 정확히 찾아야 하는 사람.
활용 예시
- "이 프로젝트에서 최근 대화 10개 보여줘" → 현재 폴더 범위로 제목·세션 ID 표가 출력됩니다.
- "지난주 Codex 스레드만 아카이브까지 포함해서 보여줘" →
--source codex --include-archived --from-date로 범위를 좁힙니다. - "모든 프로젝트의 대화를 최신순으로 훑어줘" →
--all-projects로 워크스페이스 전체 인벤토리를 확인한 뒤, 이어갈 세션 ID만 골라냅니다.
참고: 전문(全文) 키워드 검색, 삭제 파일 복구, 세션 이어가기는 같은 저장소의 다른 스킬(
claude-code-history-files-finder,continue-claude-work,continue-codex-work) 담당입니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/local-conversation-history 폴더를 내 ~/.claude/skills/local-conversation-history/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/daymade-claude-code/local-conversation-history ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- Python 3가 설치되어 있는지 확인합니다: 터미널에서
python3 --version실행. - 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 이 스킬을 복사합니다:
cp -r claude-code-skills/daymade-claude-code/local-conversation-history ~/.claude/skills/ - 스크립트 실행 권한을 부여합니다(선택):
chmod +x ~/.claude/skills/local-conversation-history/scripts/list_local_history.py - Claude Code를 재시작하고 "최근 로컬 대화 목록 보여줘"라고 요청합니다.
- (선택) 외부 백업 아카이브가 있다면
~/.claude/history-sources.json에 경로를 등록해 매번 함께 검색되게 합니다. - Windows에서는
py <스킬경로>/scripts/list_local_history.py --cwd . --limit 10형태로 실행됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT