Memento Vault: Claude 코드 세션에서 지속적 컨텍스트를 위한 로컬 도구

Memento Vault는 수동 유지 관리 없이 관련 정보를 자동으로 캡처하고 검색하여 Claude Code가 세션 간 컨텍스트를 잊는 문제를 해결합니다.

작동 방식

이 도구는 Claude Code의 라이프사이클에 연결되는 훅을 사용합니다:

• 세션이 종료될 때: 훅이 기록을 읽고 점수를 매겨 저장할 내용을 결정합니다. 중요한 세션은 로컬 git 저장소에 원자적 노트로 기록됩니다. 각 노트에는 확실성 점수와 태그를 포함한 프론트매터, 관련 노트로의 위키링크가 포함된 하나의 아이디어가 담깁니다. 사소한 세션은 일일 로그에 한 줄로 기록됩니다.
• 세션이 시작될 때: 작업할 프로젝트의 최근 세션과 가장 관련성 높은 보관소 노트를 보여주는 브리핑을 주입합니다.
• 모든 프롬프트에서: Claude가 입력을 처리하기 전에 보관소를 검색하고 일치하는 노트를 표시합니다.
• 모든 파일 읽기에서: 이전에 작업한 코드 영역에 대한 컨텍스트를 주입합니다.

기술적 세부사항

모든 검색은 LLM 호출 없이 로컬 BM25 + 벡터 검색을 사용합니다. 시스템은 프롬프트당 평균 472ms의 지연 시간을 가지며 실행 비용이 없습니다. 컨텍스트 오버헤드는 세션당 약 149 입력 단위입니다. 검색 품질 점수는 LongMemEval(500개 질문)에서 NDCG@10 = 0.892입니다.

Inception이라는 배경 통합 계층은 임베딩 유사성에 따라 노트를 클러스터링하고 세션 후 패턴 노트를 작성하여 프로젝트 전반에 걸쳐 반복되는 문제를 식별합니다.

전체 시스템은 git 저장소의 마크다운 파일을 사용하며, Obsidian에서 탐색 가능하고, grep으로 검색 가능하며, git log로 차이점을 확인할 수 있습니다. 데이터베이스, Docker, 클라우드 의존성이 없습니다.

설치

git clone https://github.com/sandsower/memento-vault.git
cd memento-vault
./install.sh --experimental

요구사항: Python 3 및 Claude Code. QMD는 의미 검색을 추가합니다(선택 사항). Linux 및 macOS에서 작동합니다.

이 프로젝트에는 271개의 테스트가 포함되어 있으며 MIT 라이선스를 따릅니다.