AI 에이전트를 위한 영구 메모리 도구 (OptMem)

AI 에이전트를 위한 영구 메모리. 426 토큰 프롬프트, 스크립트, 플러그 앤 플레이 방식입니다.

curl -fsSL https://raw.githubusercontent.com/VictorTaelin/OptMem/main/install.sh | sh

이 명령어는 ## Memory 블록을 출력합니다. 이 내용을 에이전트의 AGENTS.md (또는 CLAUDE.md) 상단에 붙여넣기만 하면 끝입니다. 업데이트하려면 같은 명령어를 다시 실행하세요.

이 도구는 ~/.optmem/memo 위치에 설치됩니다. ~/.optmem을 PATH 환경 변수에 추가하면 memo를 입력하여 사용할 수 있습니다.

• memo wake | 메모리 읽기 — 모든 세션의 첫 번째 명령어입니다.
• memo note "..." | 하나의 메모 기록: 최대 280바이트까지 한 줄을 기록합니다.
• memo nap | 만기가 된 병합(merges) 답변하기.
• memo recall <regex> | 기록된 모든 메모를 단어 단위로 검색합니다.
• memo zoom <lo>-<hi> | 트리 노드를 두 개의 절반으로 열어봅니다.
• memo forget <lo>-<hi> | 잘못된 요약을 삭제합니다. 다음 nap이 이를 재구성합니다.

병합은 한 번에 하나씩, note의 출력에서 도착합니다. 배경에서는 아무것도 실행되지 않습니다.

~/.optmem/
memo 도구: 의존성 없는 Python 3 파일 하나로 구성됨
memory/
...

memo config # 크기 확인
memo config WAKE_LINES=300 # wake가 출력할 줄 수 (96 ≈ 8k 토큰)
memo config WAKE_LINES= # 기본값으로 돌아가기

WAKE_LINES는 조정할 가치가 있는 유일한 크기이며, 이는 저장 공간 예산이 아닌 읽기 예산입니다. 이 값을 어느 방향으로든 변경해도 재계산되는 것은 없습니다.

레코드는 고정 너비(fixed width)이므로 위치 자체가 식별자(identity)가 되며, 모든 조회는 단일 탐색(seek)으로 이루어집니다. 백만 개의 메모(608 MB)에서도 wake는 0.03초가 걸립니다.

memory/ 폴더를 다른 곳에 보관하려면 $MEMORY_DIR을 설정하세요. 동기화된 폴더나 git 저장소를 사용할 수 있습니다.

이것이 설치 프로그램이 출력하는 내용이며, 전체 통합 과정입니다.

## Memory
당신의 메모리는 OptMem입니다:
- 이 도구는 `~/.optmem/memo` 입니다.
...