agentmemory

agentmemory란?

agentmemory는 AI 코딩 에이전트를 위한 로컬 “메모리 레이어”로, 에이전트의 세션 활동을 캡처한 후 이후 단계에서 빠른 리콜을 제공합니다. 단일 Node 프로세스로 머신에서 실행되며, 외부 데이터베이스 없이 JSON 형식으로 디스크에 상태를 저장합니다.

이 시스템은 자동 캡처 훅을 통해 도구 호출과 프롬프트를 수집하고, 원시 관찰 데이터를 의미 메모리로 통합하며, 하이브리드 파이프라인(BM25 + 벡터 + 지식 그래프)과 온디바이스 리랭킹을 통해 검색을 제공합니다.

외부 데이터베이스 없이 JSON 디스크 저장을 지원하는 로컬 런타임: 단일 Node 프로세스로 실행되며 데이터를 디스크에 JSON으로 저장합니다. Redis, Kafka, Postgres, Qdrant, Neo4j를 필요로 하지 않습니다.
에이전트 활동을 위한 자동 캡처 훅: PreToolUse, PostToolUse, SessionStart, Stop 및 추가 이벤트를 추가 코드 없이 메모리 파이프라인에 연결합니다.
온디바이스 리랭킹을 포함한 하이브리드 검색: BM25, 벡터, 지식 그래프 신호를 결합한 트리플 스트림 리콜과 온디바이스 리랭킹을 제공합니다. (페이지에서는 “노트북에서 P50 20ms 미만”으로 설명됩니다.)
자동 통합 및 보유 동작: 매시간 스위프가 원시 관찰 데이터를 의미 메모리로 통화

agentmemory에 외부 데이터베이스(Postgres나 Qdrant 등)가 필요한가요? 아니요. 페이지에는 “ZERO EXTERNAL DATABASES”라고 명시되어 있으며, 시스템은 단일 프로세스로 실행되고 상태는 디스크의 JSON 파일에 저장됩니다.
메모리를 저장하고 불러오는 도구는 어떻게 사용하나요? agentmemory는 memory_save와 memory_recall 같은 도구를 제공하는 MCP 서버를 노출합니다. 또한 각 도구에 대해 /agentmemory/* 경로의 REST 엔드포인트도 제공합니다.
서버가 어떤 내용을 캡처하는지 확인할 수 있나요? 포트 3113에서 뷰어가 자동으로 시작되며, 실시간 관찰 스트림, 세션 탐색기, 메모리 브라우저, 지식 그래프 시각화, 그리고 헬스 대시보드를 보여줍니다.
기존 코딩 트랜스크립트를 가져올 수 있나요? 네. 페이지에는 Claude Code JSONL 트랜스크립트를 받아들여 observations, tool uses, timeline을 재구성하는 JSONL 세션 임포트 워크플로우가 설명되어 있습니다.
agentmemory는 메모리 데이터를 다른 기기로 이동할 수 있나요? 페이지에는 인증된 HTTPS를 통한 P2P 동기화가 설명되어 있으며, bearer-token이 필요하고 자동 동기화는 지원되지 않습니다.

범용 벡터 데이터베이스 + 커스텀 에이전트 메모리 레이어: 임베딩을 저장하고 검색을 구현할 수 있지만, agentmemory가 제공하는 자동 캡처 + MCP/REST 인터페이스와 달리 오케스트레이션, 컨솔리데이션, 훅, 세션/타임라인 관리를 직접 구현해야 합니다.
코드 히스토리를 위한 로컬 지식베이스 도구(노트/그래프 스타일): 문서를 인덱싱하고 검색/그래프 뷰를 제공하는 도구는 리콜에 도움이 될 수 있지만, 여기에 설명된 훅 파이프라인을 통해 에이전트 도구 호출 und