thedotmack/claude-mem

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

해결하는 문제

Claude-Mem는 Claude Code에 지속적인 메모리를 제공하여 AI가 서로 다른 세션 간에 지식의 연속성을 유지할 수 있도록 합니다. 이는 세션이 종료되거나 재연결될 때 프로젝트 컨텍스트가 손실되는 것을 방지하며, 이전 상호작용의 관찰 내용과 도구 사용 내역이 보존되어 향후 사용에 활용될 수 있도록 보장합니다.

작동 방식

이 시스템은 라이프사이클 훅(SessionStart 및 PostToolUse 등)을 결합하여 관찰 내용을 자동으로 캡처하고 시맨틱 요약을 생성합니다. 이 데이터는 SQLite 데이터베이스와 Chroma 벡터 데이터베이스에 저장되어 하이브리드 시맨틱 및 키워드 검색이 가능합니다. Bun으로 관리되는 로컬 워커 서비스가 HTTP API와 웹 뷰어 UI를 제공합니다. 정보를 검색하기 위해 MCP 도구를 통한 "단계적 공개(progressive disclosure)" 전략을 채택하여, Claude가 먼저 결과의 압축된 인덱스를 검색한 다음, 타임라인을 보고, 마지막으로 토큰을 절약하기 위해 특정 ID에 대해서만 전체 세부 정보를 가져오도록 합니다.

대상 사용자

Claude Code, OpenCode 또는 Antigravity CLI를 사용하며 AI 에이전트가 세션 간에 프로젝트 히스토리, 버그 수정 및 기술적 결정을 기억하기를 원하는 개발자.

주요 특징

지속적 메모리: 컨텍스트가 세션 간에 자동으로 유지됩니다.
단계적 공개: 3단계 검색 워크플로우(search $ ightarrow$ timeline $ ightarrow$ get_observations)를 통해 토큰 비용을 최대 10배까지 절감합니다.
하이브리드 검색: 전체 텍스트 SQLite 검색과 Chroma 벡터 데이터베이스를 결합하여 지능적인 검색을 제공합니다.
개인정보 보호 제어: <private> 태그를 지원하여 민감한 콘텐츠를 저장에서 제외할 수 있습니다.
웹 뷰어 UI: 브라우저에서 메모리의 실시간 스트림을 제공합니다.
MCP 통합: 프로젝트 히스토리에 대한 자연어 쿼리를 위해 4개의 MCP 도구를 제공합니다.