raine/claude-history

해결하는 문제

claude-history는 Claude Code, Pi, Oh My Pi(OMP)와 같은 AI 코딩 에이전트 사용자를 위한 터미널 기반의 역사 브라우저입니다. 이 도구는 이러한 에이전트가 생성하는 방대한 양의 로컬 대화 기록(일반적으로 JSONL 파일로 저장됨)을 탐색하고 검색하며 관리하는 문제를 해결합니다.

작동 방식

이 도구는 프로젝트 디렉터리를 스캔하여 자동으로 세션 파일을 탐지합니다. 키워드 기반(어휘적) 및 의미 기반(세마틱) 검색을 통해 대화를 검색할 수 있는 터미널 사용자 인터페이스(TUI)를 제공합니다. 도구 출력, 사고 블록, 대화 내용을 인덱싱하여 검색 가능하게 합니다. 사용자는 vim 스타일의 탐색 기능을 갖춘 레저 스타일 뷰어에서 대화 기록을 확인할 수 있으며, 메시지를 내보내거나 원래 에이전트 환경으로 직접 대화를 재개하거나 포크할 수 있습니다.

대상 사용자

AI 코딩 에이전트(Claude Code, Pi, OMP)를 사용하고 과거 상호작용을 효율적으로 검색하고, 세션 기록을 관리하며, 다양한 프로젝트 워크트리 간 전환을 필요로 하는 개발자 및 고급 사용자입니다.

주요 기능

• 다중 에이전트 지원: Claude Code, Pi, Oh My Pi와 호환됩니다.
• 하이브리드 검색: 퍼지 어휘 검색과 로컬 세마틱 임베딩을 결합하여 의미 기반 검색을 제공합니다.
• TUI 대화 뷰어: 마크다운 렌더링, vim 스타일 스크롤링, 사고/도구 블록 토글 기능을 지원합니다.
• 세션 관리: 인터페이스에서 직접 대화를 재개, 포크, 이름 변경, 삭제할 수 있습니다.
• 크로스 프로젝트 포크: 다른 프로젝트의 대화를 현재 작업 디렉터리로 포크할 수 있습니다.
• Claude Code 스킬: Claude가 자신의 기록을 검색하고 읽을 수 있도록 도와주는 보조 스킬을 포함합니다.