agentmemory – AI 코딩 에이전트를 위한 영구 메모리 엔진

소개
주요 기능
하이브리드 검색 엔진
자동 훅 기반 캡처
51개 MCP 도구
4단계 메모리 생애주기
세션 리플레이
외부 의존성 없음
아키텍처
설치 및 빠른 시작
Claude Code 설치
다른 에이전트 MCP 설정
라이선스
관련 문서

agentmemory는 Claude Code, Cursor, Gemini CLI, Codex CLI 등 MCP(Model Context Protocol)를 지원하는 AI 코딩 에이전트에 세션을 초월한 영구 기억을 부여하는 오픈소스 메모리 엔진이다. BM25, 벡터 검색, 지식 그래프를 RRF 퓨전으로 결합한 하이브리드 검색으로 LongMemEval-S 벤치마크에서 R@5 95.2%를 달성했으며, 외부 데이터베이스 없이 SQLite와 iii 엔진만으로 동작한다. GitHub 스타 3,600개를 보유하고 있다.

https://github.com/rohitg00/agentmemory

소개

AI 코딩 에이전트를 매 세션마다 재교육하는 문제는 개발 생산성의 큰 장벽이다. 동일한 아키텍처를 반복 설명하고, 같은 버그를 재발견하고, 같은 코딩 선호도를 다시 가르치는 비용이 누적된다. CLAUDE.md, .cursorrules 같은 정적 파일은 약 200줄 수준에서 상한에 걸리고 빠르게 오래된 정보가 된다.

agentmemory는 이 문제를 해결한다. 에이전트가 작업하는 동안 12개의 자동 훅(hook)이 컨텍스트를 자동 캡처하고, 검색 가능한 메모리로 압축해 저장하며, 다음 세션 시작 시 적절한 컨텍스트를 자동 주입한다. 세션 1에서 JWT 인증을 구현하면, 세션 2에서 에이전트는 src/middleware/auth.ts의 jose 미들웨어, 테스트 커버리지, Edge 호환성을 위해 jsonwebtoken 대신 jose를 선택한 이유까지 이미 알고 있다.

mem0(53K 스타)와 비교해 검색 정확도(R@5 95.2% vs 68.5%)와 자동 캡처 방식에서 우위를 보이며, 외부 벡터 DB 없이 완전 셀프호스팅이 가능하다.

주요 기능

하이브리드 검색 엔진

BM25 키워드 검색, 벡터 임베딩 검색(all-MiniLM-L6-v2, 로컬·무료), 지식 그래프 검색을 RRF(Reciprocal Rank Fusion)로 결합한다. “database performance optimization”으로 검색하면 “N+1 query fix” 메모리를 찾는 시맨틱 매핑이 가능하다.

자동 훅 기반 캡처

12개의 자동 훅이 별도의 수동 작업 없이 에이전트 세션을 캡처한다. mem0의 수동 add() 호출 방식과 달리 완전 자동이다.

51개 MCP 도구

memory_smart_search, memory_save, memory_sessions, memory_governance_delete 등 51개의 MCP 도구를 제공한다. MCP를 지원하는 모든 에이전트와 클라이언트에서 동일한 메모리 서버를 공유한다.

4단계 메모리 생애주기

메모리 병합(consolidation), 감쇠(decay), 자동 삭제(auto-forget)를 포함한 4단계 생애주기 관리로 메모리 품질을 유지한다.

세션 리플레이

모든 세션을 녹화하고 재생할 수 있다. 뷰어의 Replay 탭에서 프롬프트, 도구 호출, 응답을 타임라인으로 스크럽하며 확인한다. 기존 Claude Code JSONL 트랜스크립트도 임포트 가능하다.

외부 의존성 없음

SQLite와 iii 엔진만 사용해 Qdrant, pgvector 등 외부 벡터 DB가 필요 없다. 연간 토큰 비용은 약 $10 수준으로, 전체 컨텍스트를 로드하는 방식 대비 92% 절감된다.

아키텍처

iii 엔진(Rust 기반) 위에서 TypeScript로 구현된 메모리 서버가 동작한다. MCP 서버, REST API(104개 엔드포인트), WebSocket을 통해 에이전트와 통신하며, 실시간 뷰어는 포트 3113에서 접근한다. 메모리 서버는 포트 3111에서 실행된다.

지원 에이전트: Claude Code, Cursor, Gemini CLI, Codex CLI, Cline, Windsurf, Roo Code, Aider, Claude Desktop, OpenCode, Goose, OpenClaw, Hermes 등.

설치 및 빠른 시작

# 메모리 서버 시작
npx @agentmemory/agentmemory

# 샘플 데이터로 리콜 테스트
npx @agentmemory/agentmemory demo

실시간 뷰어: http://localhost:3113

Claude Code 설치

/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

플러그인이 12개 훅, 4개 스킬, @agentmemory/mcp stdio 서버를 자동으로 등록한다.

다른 에이전트 MCP 설정

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"]
    }
  }
}

Cursor는 ~/.cursor/mcp.json, Claude Desktop은 설정 파일에 위 JSON을 추가한다.

라이선스

Apache License 2.0

AI Sparkup