Claude Code는 세션 사이의 모든 것을 잊어버립니다. 저는 여러분의 로컬 머신에서 일반 마크다운(markdown) + git으로 작동하며, 훅(hooks)을 통해 매 세션 시작 시 관련 내용을 자동으로 주입하고, 모든 MCP 에이전트에서도 작동하는 무료 오픈 소스 메모리를 구축했습니다. 클라우드 없음, DB 서버 없음, API 키 불필요. 문제는 매 새로운 세션이 제로 상태에서 시작된다는 점입니다. 똑같은 주의 사항, 똑같은 배포 명령, 똑같은 "Y 때문에 X로 결정했다"는 내용을 다시 설명해야 합니다. 클라우드 메모리 도구들이 이를 해결해주지만, 여러분의 프로젝트 컨텍스트를 자신들의 서버에 저장하기를 원합니다.

작동 방식: 여러분의 메모리는 git으로 버전 관리가 되는 일반 마크다운 파일이며, 이것이 신뢰할 수 있는 단일 원천(source of truth)입니다. git diff가 가능하며, 여러분의 소유이고, 종속성(lock-in)이 전혀 없습니다. 검색 인덱스는 단순히 이 파일들로부터 파생되어 재구축됩니다. SessionStart 훅은 (현재 진행 중인 프로젝트 범위 내에서) 관련 메모리를 각 세션 상단에 자동으로 주입합니다. 따라서 "회상 도구(recall tool)를 호출하는 것을 기억하세요"라고 할 필요가 없습니다. SessionEnd 훅은 새로운 지속적 지식을 캡처하여 git commit하며, 에이전트는 여러분이 작업하는 동안 선제적으로 기록하도록 지시받습니다.

하이브리드 검색(Hybrid search): SQLite FTS5 키워드 검색 + 선택적인 로컬 임베딩(embeddings) (Ollama)을 RRF와 결합하여 사용하며, 오프라인 상태일 때는 키워드 검색으로 전환됩니다. 내장된 MCP 서버를 통해 모든 MCP 에이전트(Gemini CLI, Cursor, OpenCode 등)에서도 작동합니다. 과거 대화 트랜스크립트에 대한 session_search를 포함하여 8개의 도구를 제공합니다. 비밀 정보(Secrets)는 기록되기 전에 삭제(redacted)되며, 저장소는 주입 표면(injection surface)으로 취급됩니다(로컬 모델의 제안은 바로 반영되지 않고 검토 대기열로 이동합니다). 완전히 로컬이며 표준 라이브러리(stdlib)만 사용합니다 — pip install 불필요, SDK 불필요, 텔레메트리(telemetry) 없음, 키 불필요. macOS/Linux/Windows 지원.

설치 방법 (Claude Code 플러그인입니다):
claude plugin marketplace add cremenescu/mem0ry4ai
claude plugin install mem0ry4ai@mem0ry4ai
Claude Code를 재시작하면 훅이 자동으로 등록됩니다. (또는 데이터를 직접 관리하는 클론에 유지하고 싶다면 git clone + python3 hooks/install.py를 사용하세요.)

GPL-2.0 라이선스이며, 저의 개인 프로젝트로 수개월 동안 매일 사용 중입니다 (~50개 프로젝트에 걸쳐 약 1,000개의 메모리 보유). 피드백과 이슈 제상을 언제나 환영합니다.

저장소(Repo): https://github.com/cremenescu/mem0ry4ai (제출자: /u/Expert-Ad7702) [링크] [댓글]