raine/claude-history

claude-history – Claude Code, Pi, Oh My Pi 대화 기록을 탐색하는 터미널 UI

기능

• 현재 프로젝트 디렉토리(또는 Claude Code, Pi, OMP의 기본 세션 폴더)를 스캔하고 기록된 모든 채팅 세션의 인덱스를 구축합니다.
• 어휘적으로 또는 의미적으로 작동하는 퍼지, 필드 인식 검색을 제공합니다(바이너리에는 후자의 ONNX Runtime 모델이 포함되어 있어 macOS에서는 추가 설치가 필요 없습니다).
• 대화의 미리보기 목록을 표시하고, vim 스타일 탐색, 뷰어 내 검색, 마크다운 렌더링, 메시지 복사 또는 내보내기가 가능한 전체 화면 뷰어를 열 수 있습니다.
• UI에서 원래 에이전트에서 세션을 재개하거나, 현재 프로젝트로 포크하거나, 이름을 바꾸거나, 삭제할 수 있습니다. 포크는 git 워크트리를 넘나들므로 다른 저장소의 대화를 현재 작업 디렉토리로 가져올 수 있습니다.
• 동반 Claude Code 스킬을 통해 Claude 에이전트가 이전 채팅을 직접 검색할 수 있습니다.

중요성 Claude Code, Pi 또는 Oh My Pi를 사용하는 개발자는 수십 개의 JSONL 트랜스크립트 파일을 축적하는 경우가 많습니다. 이전 논의를 찾거나, 솔루션을 재사용하거나, 중단된 세션을 계속하는 것은 수동적이고 오류가 발생하기 쉬운 프로세스입니다. claude-history는 그 아카이브를 검색 가능한 키보드 기반 인터페이스로 바꾸고 에이전트와 직접 통합하여 기록을 개발 워크플로우의 일급 시민으로 만듭니다.

주요 기능

기능	설명
멀티 에이전트 지원	Claude Code, Pi, OMP – 소스 라벨(CC, Pi, OMP)과 함께 모두 나열됩니다.
퍼지 + 의미 검색	접두사, 단어 경계, 필드 인식 관련성 점수; 의미를 이해하는 선택적 ONNX 기반 의미 순위 지정.
대화 뷰어	원장 스타일 표시, 마크다운 렌더링, 도구 호출 토글, 생각 블록 토글, 클립보드 복사, 파일 내보내기.
재개 / 포크 / 이름 바꾸기 / 삭제	네이티브 pi 또는 omp CLI 또는 Claude Code 재개 명령을 호출하는 원키 작업.
워크트리 인식 필터링	작성자의 workmux 도구를 사용하는 경우 목록이 자동으로 활성 워크트리로 제한됩니다.
크로스 프로젝트 포크	Ctrl+F로 모든 프로젝트의 대화를 현재 디렉토리로 가져옵니다.
시간 필터링	--since, --before, --after로 결과를 날짜 범위 또는 상대 기간으로 제한할 수 있습니다.
클립보드 처리	로컬, SSH(OSC 52), tmux 내에서 작동하며 CLAUDE_HISTORY_CLIPBOARD로 구성할 수 있습니다.
구성 가능한 UI	키 바인딩, 기본 재개 인수, 표시 옵션은 TOML 구성 파일에 설정됩니다.

설치

• 빠른 스크립트: curl -fsSL https://raw.githubusercontent.com/raine/claude-history/main/scripts/install.sh | bash
• Homebrew(macOS/Linux): brew install raine/claude-history/claude-history
• Cargo: cargo install claude-history
• 사전 빌드된 바이너리는 Apple Silicon, Intel macOS, x86_64 Linux용으로 제공됩니다. macOS 빌드에는 ONNX 런타임이 번들되어 있습니다.

기본 사용법

# 모든 프로젝트 디렉토리에서
claude-history          # TUI 목록을 엽니다
claude-history <file>   # 특정 JSONL 트랜스크립트를 직접 봅니다
claude-history delete-empty   # 빈 트랜스크립트 파일을 제거합니다

목록 내부:

• 입력하여 검색, Ctrl+R로 재개, Ctrl+F로 포크, F2로 이름 바꾸기, Ctrl+X로 삭제.
• Ctrl+T로 어휘 검색과 의미 검색을 전환합니다.
• ?로 전체 단축키 치트 시트를 표시합니다.

구성 예시 (~/.config/claude-history/config.toml)

[search]
mode = "semantic"   # 의미 모드로 시작

[tui]
semantic_search = true   # 레거시 키, 여전히 작동

누가 만들었나 raine이 유지 관리합니다(aven 작업 큐 도구의 저자와 동일). 저장소에는 Claude가 자신의 기록을 쿼리할 수 있도록 하는 동반 Claude 스킬(skills/claude-history/SKILL.md)이 포함되어 있습니다.

---

모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.