OptMem: DB 없는 에이전트 메모리

Victor Taelin이 공개한 OptMem은 임베딩 모델과 벡터 데이터베이스를 사용하지 않고, 텍스트 로그와 이진 요약 트리(binary merge tree)만으로 AI 코딩 에이전트의 영속적인 기억을 관리하는 도구다. 기존 벡터 검색 방식의 복잡한 운영 부담과 불투명성을 줄이고, 사람이 직접 읽고 수정할 수 있는 단순한 구조를 제공한다.

핵심 구조 및 작동 원리

OptMem은 기억을 한 줄씩 덧붙이는 **텍스트 로그(LOG.txt)**와 이를 기반으로 생성되는 **이진 요약 트리(TREE)**로 구성된다. 최근 기억은 원문 그대로 유지되며, 오래된 기억일수록 인접한 두 항목이 하나로 합쳐져 압축된 요약 형태로 저장된다. 요약본은 캐시 역할만 하며 원문은 로그에 보존되므로 필요 시 원문을 복원할 수 있다.

• 저장 방식: 고정 폭(fixed width) 텍스트 로그로, 위치 자체가 식별자가 되어 별도 인덱스 없이도 빠른 조회가 가능하다.
• 성능: 기억 100만 개(608MB) 기준, 전체 이력 요약 출력(wake)에 0.03초가 소요된다.
• 의존성: 파이썬 3 단일 파일로 구성되며 외부 라이브러리나 DB가 필요 없다.

주요 기능 및 사용법

설치는 스크립트 한 줄로 완료되며, 에이전트의 AGENTS.md나 CLAUDE.md에 프롬프트 블록을 붙여넣어 통합한다. 주요 명령어는 다음과 같다.

• memo wake: 세션 시작 시 트리 상위의 요약본을 출력하여 전체 이력을 파악한다.
• memo note "...": 새로운 기억을 한 줄(최대 280바이트)로 기록한다.
• memo recall <regex>: 정규표현식을 이용해 기록 전체를 문자 그대로 검색한다.
• memo nap: 대기 중인 병합 작업을 처리하여 트리를 업데이트한다.

특징 및 한계

OptMem은 단일 사용자 환경에 최적화되어 있다. 로컬 디렉토리에 저장되며, 서브에이전트가 중복 기록을 남기지 않도록 memo 실행을 금지하는 프롬프트 지시를 포함한다. 따라서 팀 단위 공유나 의미 기반 검색(semantic search)이 필요한 환경에는 적합하지 않으며, 표현이 다른 유사 개념을 찾아주는 기능은 없다. 대신 텍스트 파일 형태로 남아 투명성이 높고, Windows 네이티브 환경에서도 병렬 쓰기(8개 프로세스 동시 기록 검증 완료)가 지원된다.