ramakay/claude-self-reflect

어떤 프로젝트인가요?

핵심 기능

• 01로컬 임베딩을 사용해 과거 Claude Code 대화를 의미 기반으로 검색
• 02외부 서비스 없이 SQLite 저장소와 HNSW 벡터 색인을 사용하는 단일 Rust 바이너리
• 03관련 과거 맥락을 자동으로 삽입하는 6개의 라이프사이클 훅
• 04파일, 개념, 타임라인 및 대화 질의를 위한 MCP 도구 15개
• 05함수와 파일을 그 형성에 영향을 준 대화와 연결하는 코드 그래프
• 06활성화 시에만 MCP 등록과 훅을 설치하는 동의 기반 설정

활용 사례

• 이전 Claude Code 세션에서 버그를 어떻게 수정했거나 컴포넌트를 어떻게 설계했는지 확인
• 특정 파일이나 함수의 현재 코드에 이르게 된 대화 찾기
• 장기 프로젝트의 결정 사항을 여러 세션에 걸쳐 계속 확인

빠른 시작

1. 1

   README의 공식 설치 스크립트를 실행합니다(바이너리를 다운로드한 다음 활성화 전에 확인을 요청합니다).

2. 2

   npm으로 설치합니다(바이너리만 다운로드하며 활성화하지 않습니다).

   npm install -g claude-self-reflect
3. 3

   설정을 활성화합니다(MCP 서버를 등록하고, 훅을 설치하고, 대화를 가져옵니다).

   csr-engine setup
4. 4

   Claude Code를 다시 시작합니다.

사용 전 알아둘 점

• !미리 빌드된 바이너리는 macOS Apple Silicon, Linux x86_64/WSL, Linux ARM64를 지원합니다. Intel Mac에서는 소스에서 직접 빌드해야 합니다.
• !AI 내러티브는 선택 사항이지만 claude -p를 통해 Claude 구독을 사용하며 토큰 사용량이 추가됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

claude-self-reflect은(는) 무엇인가요?

Claude Code에 과거 대화의 영구 메모리를 제공하고, MCP 서버로 노출하는 로컬 Rust 도구입니다. Claude Self-Reflect는 Claude Code를 위한 메모리 계층입니다. ~/.claude/projects에 있는 과거 대화 기록을 색인하고 검색 가능하게 만들어, 이전 세션에서 나온 해결책과 설계 결정, 디버깅 기록을 필요할 때 다시 불러올 수 있습니다. 청크, 임베딩, 보강 상태를 SQLite에 저장하고 로컬 FastEmbed 임베딩과 HNSW 색인으로 벡터 검색을 수행하는 단일 Rust 바이너리로 제공됩니다. 기본 검색 기능에는 데이터베이스 서버나 컨테이너, API 키가 필요하지 않습니다.

claude-self-reflect은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

claude-self-reflect은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

claude-self-reflect은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. claude-self-reflect의 마지막 커밋은 2026년 11월 2일입니다.

claude-self-reflect은(는) 어디에 사용할 수 있나요?

이전 Claude Code 세션에서 버그를 어떻게 수정했거나 컴포넌트를 어떻게 설계했는지 확인 특정 파일이나 함수의 현재 코드에 이르게 된 대화 찾기 장기 프로젝트의 결정 사항을 여러 세션에 걸쳐 계속 확인

claude-self-reflect는 어떻게 설치하나요?

README의 공식 설치 스크립트를 실행합니다(바이너리를 다운로드한 다음 활성화 전에 확인을 요청합니다). npm으로 설치합니다(바이너리만 다운로드하며 활성화하지 않습니다).: npm install -g claude-self-reflect 설정을 활성화합니다(MCP 서버를 등록하고, 훅을 설치하고, 대화를 가져옵니다).: csr-engine setup Claude Code를 다시 시작합니다.

claude-self-reflect은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ramakay/claude-self-reflect