코딩 에이전트가 세션 사이를 잊지 않고 이어갈 수 있게 하는 기억 저장소
매번 같은 아키텍처를 설명하고, 같은 버그를 다시 찾아내며, 같은 선호 사항을 반복해서 알려주는 일이 사라집니다. 에이전트가 수행한 작업을 자동으로 기록하고 압축해 다음 세션에 필요한 맥락만 주입하는 도구입니다. Claude Code, Cursor, Codex CLI 등 다양한 코딩 에이전트에서 하나의 서버로 공유되는 기억을 제공합니다.
세션 간 기억의 연속성
기존의 CLAUDE.md나 .cursorrules 같은 정적 파일은 200줄 이내로 제한되어 있고 내용이 빠르게 구식이 됩니다. 이 도구는 에이전트가 수행한 작업을 조용히 포착해 검색 가능한 기억으로 압축합니다. 첫 번째 세션에서 JWT 인증을 설정했다면, 두 번째 세션에서 레이트 리미팅을 요청할 때 에이전트는 이미 src/middleware/auth.ts에 jose 미들웨어를 사용한다는 점과 Edge 호환성을 위해 jsonwebtoken 대신 jose를 선택했다는 사실을 알고 있습니다. 별도의 설명이나 복사 붙여넣기 없이 이전 작업의 맥락이 자연스럽게 이어집니다.
검색 정확도와 토큰 효율
LongMemEval-S 벤치마크에서 95.2%의 R@5 정확도를 기록했으며, 이는 BM25 단독 사용 시 86.2%보다 높은 수치입니다. 로컬 임베딩을 함께 사용할 경우 연간 비용은 0달러가 되며, API 키 없이도 BM25 기반 키워드 검색을 통해 기본 기능을 사용할 수 있습니다. 하이브리드 검색은 BM25, 벡터, 그래프 매칭을 결합해 시간적 순서와 의미적 관련성을 모두 고려합니다.
설치와 에이전트 연결
Node.js 20 이상 환경에서 npx -y @agentmemory/agentmemory@latest 명령으로 설치를 시작합니다. 첫 실행 시 대화형 설정을 통해 사용할 에이전트를 선택하고 LLM 제공자를 지정하거나 키 없이 사용할 수 있습니다. macOS와 Linux에서는 iii-engine이 자동으로 설치되지만, 네이티브 Windows에서는 WSL2 또는 Docker Desktop을 사용하거나 특정 버전의 iii.exe를 수동으로 설치해야 합니다. agentmemory connect <agent> 명령으로 Claude Code, Cursor, Codex CLI 등 20개 이상의 에이전트를 추가로 연결할 수 있으며, 모든 에이전트는 동일한 메모리 서버를 공유합니다.
라이프사이클 관리와 실시간 뷰어
기억은 4단계 통합, 감쇠, 자동 삭제 과정을 거치며 관리됩니다. 3113 포트에서 제공하는 실시간 뷰어에서는 세션 리플레이를 통해 프롬프트, 도구 호출, 결과를 타임라인으로 재생할 수 있습니다. 0.5배속부터 4배속까지 속도를 조절하며 세션의 흐름을 추적할 수 있고, Claude Code의 JSONL 트랜스크립트를 가져와 기존 세션도 검색 및 재생 대상에 포함시킬 수 있습니다. import-jsonl 명령을 사용하면 과거의 세션 기록을 현재 시스템에 통합할 수 있습니다.
사용 전 확인 사항
이 도구는 iii-engine v0.22.1에 고정되어 있어 다른 버전의 엔진과 함께 작동하지 않습니다. Windows 사용자는 네이티브 환경의 제한 사항을 반드시 확인해야 하며, WSL2가 가장 안정적인 경로입니다. 키 없이 사용할 경우 벡터 임베딩이 비활성화되어 의미론적 검색 대신 키워드 검색만 가능합니다. 로컬 임베딩 모델을 사용하려면 EMBEDDING_PROVIDER=local을 설정하고 초기 모델 다운로드를 허용해야 합니다. 데이터 저장 위치는 플랫폼별 기본 경로를 따르며, --data-dir 옵션으로 명시적으로 지정할 수 있습니다.