lucasrosati/claude-code-memory-setup

What it solves

이 프로젝트는 Claude Code에 지속적인 장기 기억과 코드베이스 인지 능력을 제공하기 위한 포괄적인 설정을 제공합니다. 두 가지 주요 문제를 해결합니다: 세션 간의 "失忆症" (사용자가 프로젝트를 설명을 다시 해야 하는 경우) 및 Claude가 매 세션마다 구조를 이해하기 위해 전체 코드베이스를 다시 읽는 데서 발생하는 높은 토큰 소비량입니다.

How it works

시스템은 컨텍스트를 관리하기 위해 다층적인 접근 방식을 사용합니다:

• Persistent Memory: Obsidian Zettelkasten 보관함(vault)이 "두 번째 뇌" 역할을 하여 결정 사항, 아키텍처, 세션 로그를 저장합니다. Claude Code는 CLAUDE.md 파일과 /resume 및 /save와 같은 커스텀 커맨드를 통해 이 보관함과 상호작용합니다.
• Codebase Mapping: Graphify를 통합하여 코드를 쿼리 가능한 지식 그래프로 변환합니다. 원본 파일을 읽는 대신 Claude가 구조적 맵(AST-based)을 쿼리합니다. 이는 토큰 사용량을 크게 감소시킵니다.
• Chat Pipeline: Python 기반의 임포트 파이프라인이 Claude 대화(CLI 및 Web app 모두)를 인덱스화된 노트로 Obsidian 보관함에 내보보냅니다.
• Auto-Save Safety Net: Claude Code의 SessionEnd hook으로 등록된 Python 스크립트가 사용자가 수동으로 저장하는 것을 잊었을 경우, 세션 사실을 추출하여 보관함에 최소한의 로그를 자동으로 작성합니다.

Who it's for

API 비용(tokens)을 줄이고 여러 세션에 걸쳐 프로젝트 결정 사항과 코드베이스 구조에 대한 지속적이고 검색 가능한 지식 베이스를 유지하고자 하는 Claude Code 사용자(개발자)를 위한 것입니다.

Highlights

• Token Efficiency: 전체 파일 읽기를 그래프 쿼리로 대체함으로써 세션당 토큰 사용량을 최대 71.5배 감소시킬 수 있다고 주장합니다.
• Zettelkasten Integration: Obsidian의 원자적이고 상호 연결된 노트를 사용하여 선언적 메모리를 구현합니다.
• Local Processing: tree-sitter AST를 통해 코드베이스 그래프를 그래프를 처리합니다. 이는 기본 모드에서 코드 내용이 머신을 떠나지 않음을 보정합니다.
• Automated Sync: 채팅 히스토리를 지식 보관함으로 동기화하기 위해 cron-scheduled 스크립트를 포함합니다.