agents-memory

AI 코딩 어시스턴트를 위한 로컬 마크다운 메모리 및 크로스 에이전트 컨텍스트 엔진.
Claude Code, Cursor, Antigravity, Zed에서 공유되는 하나의 영구적인 정체성.

왜 .agents/memory인가?

agents-memory 라는 이름은 보편적인 저장 표준인 .agents/memory 에서 직접 유래했습니다.

• 전역: ~/.agents/memory/는 영구적인 정체성, 스택 기본값, 지속적인 개념, 프로젝트 인덱스를 저장합니다.

• 저장소: <repo>/.agents/memory/는 저장소별 사실, 아키텍처 ADR, 스테이징 인박스를 저장합니다.

AI 공급업체들이 독점 저장소에 설정을 분산시키는 동안, .agents/는 모든 에이전트 설정과 공유 지능을 위한 단일하고 개방적이며 공급업체 중립적인 파일시스템 허브를 제공합니다.

agents-memory는 순수 Markdown 우선 아키텍처로 이를 구현합니다:

• 로컬 및 오프라인: 정체성과 저장소 메모리는 일반 파일(~/.agents/memory/ 및 <repo>/.agents/memory/)에 저장됩니다.

• 사람이 읽을 수 있고 Git 친화적: 어떤 텍스트 편집기로도 편집하고, git으로 diff하고, 원할 때 커밋할 수 있습니다.

• 범용 MCP 서버: 모든 최신 에이전트에 메모리 도구(search_memory, add_memory, get_project_memories, distill_batch)를 노출합니다.

• 자율 수집 및 증류: 세션 로그(OpenAI, Claude, Cursor, Copilot, Antigravity, Pi)에서 지속적인 규칙과 아키텍처 결정을 추출합니다.

Related MCP server: agent-julia

아키텍처 및 흐름

 ┌─────────────────────────────────────────────────────────────┐
 │                       SESSION INGEST                        │
 │  OpenAI Exports · Claude JSONL · Cursor · Antigravity · Pi  │
 └──────────────────────────────┬──────────────────────────────┘
                                │  ingest catalog / extract
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                       STAGING INBOX                         │
 │        Raw captured bullets & noise-filtered facts          │
 └──────────────────────────────┬──────────────────────────────┘
                                │  distill_batch / skill
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                     LOCAL MEMORY STORE                      │
 │   ~/.agents/memory/USER.md     ~/.agents/memory/PROJECTS.md │
 │   ~/.agents/memory/concepts/   <repo>/.agents/memory/       │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │       IDE INJECTION         │ │     MCP SERVER & CLERK      │
 │  Cursor Rules · Zed Context │ │  search_memory · add_memory │
 │  Antigravity AGENTS.md      │ │  Universal Tool Integration │
 └─────────────────────────────┘ └─────────────────────────────┘

빠른 시작

1단계 설정

pip install agents-memory && agents-memory sync --init

~/.agents/memory/를 스캐폴딩하고, 설치된 IDE에 MCP 구성을 자동 연결하며, 어시스턴트 스킬을 등록합니다.

[!TIP] 🤖 에이전트 주도 설정 (제로 프릭션):
코딩 에이전트에게 간단히 말하세요: "agents-memory를 설치하고 설정해줘."
에이전트가 패키지를 설치하고, 스택 선호도를 한 번 물어본 뒤 USER.md 프로필을 작성하고, 저장소를 자율적으로 등록합니다.

CLI 참조

지원 생태계

• Claude Code: 심볼릭 링크 / 표준 AGENTS.md 및 MCP 서버를 통해 바인딩.

• Google Antigravity: .gemini/config 규칙 및 agents-memory MCP를 통해 통합.

• Cursor: 규칙을 자동으로 주입하고 .cursor/mcp.json을 구성.

• Zed: context_servers를 구성하고 어시스턴트 스킬을 미러링.

• VS Code / Copilot: 로컬 상태 데이터베이스에서 세션 기록을 수집.

또한 호환 가능: Windsurf, Cline, Roo-Code, Aider, Continue.dev, OpenAI ChatGPT, Pi, Goose 및 모든 MCP 호환 AI 어시스턴트.

공개 ABI 사양

공식적이고 구현에 구애받지 않는 레이아웃 사양은 abi/에 있습니다:

• abi/WHY.md — 아키텍처 결정 및 Markdown이 RAG보다 나은 이유.

• abi/LAYOUT.md — 디렉터리 분류 및 경로 계약.

• abi/KINDS.md — 유형화된 메모리 분류(concepts, facts, decisions).

• abi/MCP.md — 도구 정의 및 요청/응답 사양.

• abi/INGEST.md — 카탈로그, 추출, 증류 파이프라인.

• abi/INJECTION.md — 호스트 규칙 주입 메커니즘.

테스트 및 검증

포괄적인 테스트 스위트와 증류 벤치마크를 실행하세요:

python tests/run_all_tests.py

라이선스

MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.