session-index은(는) 무엇을 하나요?
Claude Code 대화를 SQLite에 색인하고, 로컬 LLM 요약과 검색 스킬을 통해 과거 세션을 기억할 수 있게 합니다.
개요
이 프로젝트는 Claude Code 세션을 자동으로 색인하여, AI 어시스턴트가 이전 작업을 잊지 않고 이어갈 수 있도록 도와줍니다. ~/.claude/sessions.db SQLite 데이터베이스에 세션 기록, 명령어, 파일 변경사항을 저장하며, 종료 시 로컬 LLM으로 세션 요약을 생성합니다.
설치
# 저장소 클론
gh repo clone rolandtolnay/session-index ~/.claude/commands/session-index
# 의존성 설치 (uv 권장)
cd ~/.claude/commands/session-index
uv sync
사용법
자동 색인
Claude Code가 on_session_end 후크를 통해 세션 데이터를 자동으로 저장합니다.
수동 명령어
index session- 현재 세션을 수동으로 색인합니다.search sessions <query>- 과거 세션을 검색합니다.last sessions- 최근 5개 세션의 요약을 표시합니다.
구성
~/.claude/commands/session-index/.env 파일에서 다음 옵션을 설정할 수 있습니다:
| 변수 | 설명 | 기본값 |
|---|---|---|
LLM_MODEL | 요약에 사용할 로컬 LLM 모델 | llama3.2:3b |
LLM_HOST | LLM 서버 주소 | http://localhost:11434 |
DB_PATH | SQLite 데이터베이스 경로 | ~/.claude/sessions.db |
작동 방식
- 색인: 각 세션의 메타데이터(시작 시간, 명령어, 파일 변경)를 SQLite에 저장합니다.
- 요약: 세션 종료 시 로컬 LLM(Ollama 등)을 호출해 세션의 목적과 결과를 요약합니다.
- 검색: Claude가
search sessions명령어로 과거 세션을 찾고 관련 정보를 컨텍스트에 포함합니다.
요구사항
- Claude Code
- Python 3.10+
- (선택) Ollama 또는 기타 로컬 LLM 서버
라이선스
MIT