AI Tech Briefing

claude-mem

claude-mem은 AI coding assistant의 세션 관찰을 자동 저장, 압축, 검색, 재주입하는 persistent memory plugin이다.

2026-04-17

왜 중요한가

  • 실무 기준으로는 에이전트의 약점은 세션이 바뀔 때 맥락이 쉽게 증발한다는 점이다.
  • claude-mem은 이 문제를 transcript 누적이 아니라 관찰 압축과 search-first retrieval 방식으로 다룬다.
  • Claude Code뿐 아니라 Gemini CLI, OpenCode, Codex CLI, OpenClaw까지 지원 범위를 넓히는 점도 실용적이다.

핵심 관찰

  • 로컬 Windows 환경에서 repo를 직접 clone했다.
  • package.json 기준 현재 버전은 12.1.6, Node 요구사항은 >=18.0.0, Bun 요구사항은 >=1.0.0이었다.
  • npm view claude-mem에서도 latest가 12.1.6으로 확인됐다.
  • npm pack --dry-run 결과 배포물 안에 dist/npx-cli/index.js, Claude plugin hooks, skills, UI viewer, OpenClaw plugin 파일이 포함돼 있었다.
  • 특히 tarball 안에 openclaw/openclaw.plugin.json, openclaw/SKILL.md, openclaw/install.sh가 포함돼 있어 OpenClaw 연동이 실제 패키지 수준에서도 확인됐다.
  • npx claude-mem --help를 직접 실행했더니 install/update/uninstall 외에 start, stop, status, search, transcript watch 같은 런타임 명령과 claude-code, gemini-cli, opencode, openclaw, codex-cli 등의 IDE 식별자가 실제로 노출됐다.
  • Claude plugin hook 설정은 SessionStart, UserPromptSubmit, PostToolUse, PreToolUse, Stop, SessionEnd 단계에서 worker service와 context injection을 호출하도록 되어 있었다.
  • OpenClaw plugin manifest에는 syncMemoryFile, workerPort, project, observationFeed 같은 설정이 정의돼 있었고 라이브 observation feed도 지원하도록 설계돼 있었다.
  • README 배지와 실제 package 버전 표기가 다르게 보여 문서 동기화는 완벽하지 않아 보였다.

해석

claude-mem은 AI coding assistant의 세션 관찰을 자동 저장, 압축, 검색, 재주입하는 persistent memory plugin이다.

누구에게 도움이 되나

  • Claude Code/Gemini CLI 사용자: 긴 프로젝트에서 세션 단절 비용 감소
  • 소규모 개발팀: 작업 맥락과 의사결정의 다음 세션 전달
  • 운영팀: 반복 조사나 장애 대응의 관찰 기록 보존

어디에 바로 써볼 수 있나

  • agent memory를 관찰 압축, 검색, 재주입으로 다루는 설계 사례 연구
  • 장기 개발/운영 세션에서 맥락 손실 감소와 회수 품질 개선 실험
  • OpenClaw assistant에 cross-session memory, observation feed, search-first retrieval를 붙일 때 참고
  • 긴 프로젝트에서 세션 단절 비용 감소
  • 작업 맥락과 의사결정의 다음 세션 전달
  • 반복 조사나 장애 대응의 관찰 기록 보존

주요 출처

공식 repo / docs

주의점

  • 자동 메모리는 privacy 통제가 중요하다.
  • worker service, Bun, hook 구조까지 포함돼 운영 복잡도가 있다.
  • 과거 맥락이 잘못 압축되면 현재 판단을 오염시킬 수 있다.
  • README와 실제 패키지 버전 표기 차이처럼 문서 동기화 이슈도 보인다.

다음에 볼 포인트

  • 세션 메모리와 장기 메모리의 범위 분리가 더 명시적인 제품 기본값으로 굳어지는지 볼 것.
  • skills, orchestration, writable memory를 어떤 정책 경계로 나누는지 비교할 것.