thedotmack/claude-mem

Claude‑Mem – Claude Code용 지속 가능한 메모리

무엇인가요 – Claude‑Mem은 TypeScript/Node 기반의 플러그인으로, Claude Code(Anthropic의 IDE 어시스턴트)에 지속적이고 검색 가능한 메모리 기능을 추가합니다. 개발자의 도구 사용을 모니터링하고, 관찰 내용을 컴팩트한 의미적 요약으로 변환하여 로컬 SQLite + Chroma 벡터 저장소에 저장하며, 향후 Claude 세션에서 관련 컨텍스트를 활용할 수 있게 합니다.

주요 기능

• 자동 캡처 – 세션 시작, 프롬프트 제출, 도구 사용 후, 중지, 세션 종료 등의 라이프사이클 훅이 사용자가 복사/붙여넣기할 필요 없이 관찰 내용을 기록합니다.
• 하이브리드 검색 – 풀텍스트 + 벡터(Chroma) 검색을 통해 mem‑search 기술을 통해 자연어로 과거 작업을 질의할 수 있습니다.
• 3단계 토큰 절약 워크플로우 – search → timeline → get_observations는 Claude가 읽어야 하는 텍스트 양을 약 10배 줄입니다.
• 웹 UI 및 워커 서비스 – 로컬 Bun 기반 HTTP 서버로 실시간 메모리 스트림을 표시하고 API를 노출하며, Slack/Discord/Telegram으로 업데이트를 전송할 수 있습니다.
• 개인정보 보호 제어 – <private> 태그로 민감한 스니펫을 제외할 수 있으며, 어떤 관찰 내용을 Claude의 컨텍스트에 삽입할지 설정할 수 있습니다.
• 클라우드 동기화 옵션 – 선택적 CMEM .ai 서비스로 SQLite 저장소를 백업할 수 있으며, 그렇지 않으면 모든 데이터는 로컬에 유지됩니다.
• 다중 IDE 지원 – npx claude-mem install --ide grok-bot, opencode, antigravity 또는 Claude Code 플러그인 마켓플레이스에서 직접 설치 가능합니다.

시작 방법

1. npx claude-mem install (또는 IDE 전용 명령어)를 실행합니다. 설치 프로그램은 플러그인을 등록하고 Bun 워커를 시작하며, 메모리 키를 얻기 위한 로그인을 요청합니다(옵션. --provider host를 사용하면 완전히 오프라인으로 실행 가능).
2. Claude Code가 재시작되며, 다음 세션부터 이전 관찰 내용이 자동으로 표시됩니다.
3. 내장된 mem‑search 기술이나 MCP 도구(search, timeline, get_observations)를 사용하여 과거 메모를 검색합니다.

설정 – 설정은 ~/.claude-mem/settings.json에 저장됩니다. 다음을 전환할 수 있습니다:

• 세션 시작 시 삽입되는 소스(CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES).
• AI 모델/프로바이더(Anthropic, OpenRouter, Gemini).
• 언어/모드(code, code--zh 등).
• 포트, 로그 레벨, 워커 기타 옵션.

대상 사용자 – 코드 생성 또는 디버깅에 Claude Code를 의존하며, 재시작, CI 실행, 또는 다른 기계 간에도 지식을 유지하고 싶은 개발자.

라이선스 – Apache 2.0 (별도의 ragtime/ 하위 모듈 포함).