agent-memory

코딩 에이전트를 위한 로컬 마크다운 메모리 — 모든 프로바이더, 모든 도구.

공유 레이아웃이 없으면 각 벤더는 묘지를 소유하게 됩니다. 즉, 새 에이전트마다 다시 가르치지 않는 한 세션 아카이브는 영구적인 정체성이 되지 못합니다. 전체 근거(RAG, 볼트, 벤더 메모리와의 비교)는 abi/WHY.md 를 참조하세요. 참조 구현 로드맵: ROADMAP.md.

메모리는 사용자가 소유한 폴더에 저장됩니다: ~/.agents/memory(정체성 + 프로젝트 맵) 및 <repo>/.agents/memory(프로젝트별 작업). 에이전트 — 또는 마크다운과 선택적 MCP를 읽는 모든 호스트 — 는 동일한 레이아웃을 사용합니다.

마크다운이 진실의 원천입니다. 이 저장소의 Python MCP는 참조 구현이지 독점 백엔드가 아닙니다.

ABI(안정적 계약)

abi/ 아래에 제공 — 버전 관리, 문서화, 구현 비종속:

설치는 abi/LAYOUT.md → ~/.agents/memory/LAYOUT.md 를 복사합니다. 주입 및 CLI 플래그: abi/INSTALL.md. 머신 판독 가능: python -m agent_memory --help-json.

Related MCP server: mcp-chest-memory

참조 구현 (이 저장소)

Python은 src/agent_memory/ 에 있습니다 (클론에서 pip install -e .).

템플릿은 git에만 존재: examples/*.example.*. 라이브 저장소: ~/.agents/memory. 마크다운이 이 클론에 유출된 경우 python -m agent_memory consolidate 를 실행하세요.

코딩 에이전트: 설치 방법은 AGENTS.md 를 따르세요.

레이아웃 (요약)

검색은 사용자 + 등록된 모든 프로젝트 트리를 통합합니다. 채팅 본문은 제품 폴더에 유지됩니다. chats-index.md 는 제목 + 경로만 포함합니다.

설정

pip와 MCP에 동일한 인터프리터 사용:

python -m pip install -e .
python -m agent_memory sync --init
python -m agent_memory inventory

~/.agents/memory/USER.md 와 scan.json 을 채우세요 (최초 실행 시 examples/*.example.* 에서). MCP 병합 후 에이전트를 다시 로드하세요.

Windows 심볼릭 링크 스텁 및 하드링크 대체는 abi/PLATFORM.md 를 참조하세요.

스크립트

python -m agent_memory inventory
python -m agent_memory inventory --json
python -m agent_memory inventory --register SLUG "/path/to/repo" "role" "stack"
python -m agent_memory sync
python -m agent_memory --help-json
python -m agent_memory sync --help-json
python -m agent_memory inventory --help-json
python -m agent_memory ingest catalog

설치 후 PATH의 agent-memory 는 python -m agent_memory 와 동일합니다.