clauhist: 전체 Claude Code 기록을 탐색하고 프로젝트 간 세션을 재개하기

Source: Dev.to

Overview

Claude Code는 작업 디렉터리로 이동한 뒤 /resume 명령을 사용하면 해당 프로젝트에서 작업을 재개할 수 있습니다.
하지만 이 방법은 현재 작업 디렉터리에만 묶여 있다는 제한이 있습니다. 다른 저장소와 디렉터리에서의 세션까지 포함해 과거 작업 전체를 살펴보고 싶다면 번거로워집니다.

clauhist는 그런 경우에 사용할 수 있는 작은 CLI 도구입니다. fzf 로 Claude Code 히스토리를 보여주고, 디렉터리를 가로질러 세션을 탐색하며, 목록에서 선택한 세션을 재개할 수 있습니다.

What it shows

세션은 최근 활동 순으로 정렬됩니다. 각 행에는 다음 정보가 포함됩니다:

• 마지막 활동 시간
• 프로젝트 경로
• 경로 존재 여부 (✓ 존재, ✗ 없음)
• 첫 번째 메시지 미리보기
• 메시지 개수

미리보기 창에는 세션 ID, 타임스탬프, 전체 메시지 목록이 표시됩니다. 원하는 세션을 찾았다면 Enter 키를 누르세요.

How it works

clauhist는 ~/.claude/history.jsonl 파일을 읽어 세션별로 그룹화하고, 그 결과를 fzf에 전달합니다.
세션을 선택하면 다음 명령을 실행합니다:

claude --resume 

이 도구는 자체 데이터베이스를 유지하거나 히스토리 레이어를 추가하지 않습니다; Claude Code의 기존 히스토리 파일을 얇게 탐색하는 역할만 합니다.

Installation

From crates.io

cargo install clauhist

From source

git clone https://github.com/lef237/clauhist.git
cd clauhist
cargo install --path .

또한 fzf와 Claude Code가 설치되어 있어야 합니다.

Usage

clauhist

Main controls

디렉터리가 이동되었거나 삭제된 경우(✗), 세션을 재개할 수는 있지만 원래 디렉터리로 cd 하는 데 실패할 수 있습니다.

Shell integration

쉘 설정 파일에 다음을 추가하세요 (예: zsh):

eval "$(clauhist init zsh)"

이제 clauhist는 Claude Code를 실행하기 전에 현재 쉘을 선택한 프로젝트 디렉터리로 변경합니다.
통합을 사용하지 않으면 clauhist는 디렉터리 변경을 서브쉘에서 수행하므로 Claude를 종료하면 원래 디렉터리로 돌아갑니다. Bash와 fish도 지원됩니다.

Local‑only

clauhist는 ~/.claude/history.jsonl만 읽고 claude --resume을 실행합니다. 히스토리를 외부로 전송하지 않습니다.

Example output

Claude Code History Browser  [Enter: resume  Ctrl-/: toggle preview  Ctrl-C: cancel]
Search:
> 2026-03-18 09:12  ✓ ~/projects/myapp      Tell me about Rust error handling…  (12)
  2026-03-17 22:45  ✓ ~/sandbox/api-client  Generate client from OpenAPI schema  (8)
  2026-03-17 14:30  ✗ ~/old-project         Database migration steps             (3)

(실제 화면은 사용 중인 터미널 및 fzf 버전에 따라 다릅니다.)

세션을 선택하고 Enter 키를 누르면 clauhist가 해당 프로젝트 디렉터리에서 claude --resume을 실행합니다. Claude를 종료하면 원래 쉘로 돌아갑니다.

Requirements

Repository

소스 코드와 릴리스는 GitHub에서 확인할 수 있습니다:

https://github.com/lef237/clauhist