agentmemory: 모든 코딩 LLM 에이전트를 위한 지속적이고 토큰 효율적인 메모리

agentmemory – AI 코딩 에이전트를 위한 지속적 메모리

정의 – agentmemory는 대규모 언어 모델 기반 코딩 어시스턴트(Claude Code, GitHub Copilot CLI, Gemini CLI, Codex CLI, Cursor 등)와 함께 작동하는 셀프 호스팅 메모리 엔진입니다. 에이전트가 수행하는 작업을 자동으로 기록하고, 정보를 검색 가능한 저장소로 압축하며, 에이전트가 다음에 실행될 때 적절한 컨텍스트를 주입하여 코드베이스, 인증 설정 또는 과거의 버그를 다시 설명할 필요가 없도록 합니다.

핵심 아이디어

  • 오픈소스 iii engine (v0.11.2)을 기반으로 구축되었으며 SQLite만을 사용합니다 – 외부 벡터 DB가 필요 없습니다.
  • 하이브리드 검색: BM25 + 로컬 임베딩 (all-MiniLM-L6-v2) + 그래프 기반 RRF 융합.
  • **12개의 내장 훅(hooks)**을 통한 자동 캡처; 수동 add() 호출이 필요 없습니다.
  • 멀티 에이전트 인식: 단일 메모리 서버(agentmemory on port 3111)가 모든 MCP 또는 HTTP 호환 에이전트에 서비스를 제공할 수 있어, 여러 에이전트가 동일한 지식 베이스를 공유할 수 있습니다.
  • 수명 주기 관리: 저장소를 최신 상태로 유지하고 토큰 효율성을 높이기 위해 4단계 통합, 감쇠 및 자동 삭제 기능을 제공합니다.

설치 및 빠른 시작

# Global install (adds the `agentmemory` command)
npm install -g @agentmemory/agentmemory
# Start the memory server (default data dir under your OS’s app-data folder)
agentmemory                     # → listens on :3111
# Run a demo that seeds sample sessions and verifies recall
agentmemory demo               # or: agentmemory demo --serve
# Wire a coding agent into the memory server
agentmemory connect claude-code   # works for copilot-cli, codex, cursor, gemini-cli, etc.

npx @agentmemory/agentmemory를 사용하여 일회성으로 실행할 수도 있습니다 – 첫 실행 시 ~/.agentmemory/bin에 고정된 iii engine이 설치됩니다.

지원되는 에이전트 – MCP (Memory-Control-Protocol) 또는 간단한 REST API를 구현하는 모든 도구. README에는 Claude Code, GitHub Copilot CLI, OpenClaw, Hermes, pi, OpenCode, Cursor, Gemini CLI, Aider, Warp 등이 포함된 54개의 통합 사례가 나열되어 있습니다.

벤치마크

Metric Result
Recall @5 (LongMemEval-S, 500 Q) 95.2 %
Recall @10 98.6 %
MRR 88.2 %
Token savings vs pasting full context ~170 K tokens/yr (≈ $10/yr)
Retrieval latency (top-5) 14 ms
Hybrid vs grep baseline (coding-agent-life-v1) 100 % top-5 hit rate, 1 000 ms latency vs 0 ms grep

이 프로젝트는 또한 저장된 메모리를 검사할 수 있는 실시간 뷰어(localhost:3113)와 codegraph, Understand Anything, Graphify와 같은 그래프 인덱싱 도구와 결합할 수 있는

Sources