# 5분 설치로 AI 건망증 종결
npx openmemory-plus install

┌─────────────────────────────────────────────────────────────┐
│ OpenMemory Plus 미사용 시 │
├─────────────────────────────────────────────────────────────┤
...

┌─────────────────────────────────────────────────────────────┐
│ [Gemini CLI] 오전 │
│ 사용자: 나는 TypeScript와 pnpm을 사용하는 것을 좋아해 │
...

<!-- _omp/memory/techContext.md (자동 생성) -->
## 배포 설정
- Vercel URL: https://my-app.vercel.app
...

openmemory (사용자 수준, 프로젝트 간 공유):
├── "사용자 선호도: JavaScript 대신 TypeScript 사용"
├── "사용자 선호도: npm 대신 pnpm 사용"
...

<!-- _omp/memory/techContext.md (자동 기록) -->
## 기술 결정
### 데이터베이스 선정 (2026-02-01)
...

😤 매일 반복되는 고통의 굴레:
[오전 - Gemini CLI]
사용자: 나는 TypeScript를 선호하며, pnpm을 사용함
...

✅ 한 번의 설정으로 어디서든 적용:
[오전 - Gemini CLI]
사용자: 나는 TypeScript를 선호하며, pnpm을 사용함
...

# openmemory (모든 CLI 공유)
사용자 선호도:
- 언어: TypeScript
...

# 방식 1: 설치 시 자동 감지 및 Docker Compose 사용
npx openmemory-plus install
# 방식 2: Docker Compose 모드 명시적 사용
...

/memory # 메모리 상태 표시 + 빠른 메뉴
/mem search <query> # 메모리 검색
/mem sync # 동기화 및 충돌 감지
...

openmemory-plus/
├── cli/ # CLI 도구 소스코드
│ ├── src/
...

| 구성 요소 | 기술 | 설명 |
|---|---|---|
| CLI | TypeScript + Commander | 명령줄 도구 (Command Line Interface) |
| ... | ... | ... |

대화/작업 → 정보 탐지 → 지능형 분류 → 구조화된 추출 → 이중 계층 저장
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
...

가치 있는 정보가 탐지됨
│
▼
...

다음 내용을 자동으로 탐지하여 **저장을 차단**합니다:

| 유형 | 탐지 패턴 | 예시 |
|---|---|---|
| API Key | `sk-` , `api_key` , `token=` | `sk-xxx...` |
| 비밀번호 | `password` , `secret` | `password: 123456` |
| 개인키 (Private Key) | `-----BEGIN` , `PRIVATE KEY` | SSH/GPG 키 |
| 개인정보 | 신분증, 은행 카드, 휴대폰 번호 | `13800138000` |

| 특징 | OpenMemory Plus | 순수 openmemory MCP | 원시 mem0 SDK | 수동 .env | Notion/문서 |
|---|---|---|---|---|---|
| 자동 추출 | ✅ 대화 종료 시 자동 트리거 | ❌ | ❌ | | |
| ... | ❌ 코드 통합 필요 | ❌ | ❌ | | |
| ROT 메모리 정리 | ✅ 중복/오래된 정보 자동 식별 | ❌ | ❌ | ❌ | ❌ |
| 에빙하우스 (Ebbinghaus) 망각 곡선 | ✅ 망각 곡선 모델 적용 | ❌ | ❌ | ❌ | ❌ |

범례: ✅ 완전 지원 | ⚠️ 부분 지원 | ❌ 지원하지 않음

| 비교 항목 | OpenMemory Plus | 순수 openmemory MCP |
|---|---|---|
| 메모리 트리거 | 대화 종료 시 자동 추출, 사용자 개입 불필요 | Agent가 `add_memories` 도구를 능동적으로 호출해야 함 |
| 프로젝트 컨텍스트 | `_omp/memory/`에 프로젝트 결정 사항 및 아키텍처 저장 | 프로젝트 단위 메모리 없음, 모든 메모리가 사용자 단위로 혼재됨 |
| 메모리 분류 | preferences/decisions/patterns 등으로 자동 분류 | metadata 파라미터를 수동으로 전달해야 함 |
| 메모리 건강도 | ROT 탐지 + 건강도 점수 + 망각 모델 | 없음, 메모리가 줄어들지 않고 계속 쌓이기만 함 |
| IDE 설정 | AGENTS.md/CLAUDE.md 등을 자동 생성 | 각 IDE를 수동으로 설정해야 함 |

**Q: OpenMemory Plus와 mem0는 어떤 관계인가요?**

**A:** OpenMemory Plus는 mem0의 **강화 계층 (Enhancement Layer)**이며, 대체제가 아닙니다.

**mem0**가 기초적인 벡터 저장소 및 시맨틱 검색 (Semantic Search) 능력을 제공한다면, **OpenMemory Plus**는 그 기반 위에 다음을 추가합니다:
- 이중 메모리 아키텍처 (프로젝트 단위 + 사용자 단위)
- 지능형 분류 및 자동 추출
- 다중 IDE 통합 설정
- 민감 정보 필터링

먼저 mem0/openmemory MCP를 설치한 후, OpenMemory Plus를 사용하여 이를 강화해야 합니다.

**Q: 제 데이터는 어디에 저장되나요? 안전한가요?**

**A:** 데이터는 두 곳에 저장됩니다:

| 저장 위치 | 데이터 유형 | 보안성 |
|---|---|---|
| `_omp/memory/` (로컬) | 프로젝트 설정, 기술적 결정 사항 | ✅ 로컬 파일, Git 버전 관리 가능 |
| `openmemory` (Qdrant) | 사용자 선호도, 기술 (Skills) | ✅ 로컬 Docker 컨테이너 |

- 모든 데이터는 **사용자의 로컬 머신**에 저장됩니다.
- 민감한 정보 (API Key, 비밀번호)는 **자동으로 필터링**되어 저장되지 않습니다.
- 프로젝트 단위 데이터는 `.gitignore`를 통해 제외할 수 있습니다.

**Q: 어떤 IDE/Agent를 지원하나요?**

**A:** 현재 다음을 완전 지원합니다:

| IDE | 설정 파일 | 상태 |
|---|---|---|
| Augment | `AGENTS.md` | ✅ 완전 지원 |
| Claude Code | `CLAUDE.md` | ✅ 완전 지원 |
| Cursor | `.cursorrules` | ✅ 완전 지원 |
| Gemini CLI | `gemini.md` | ✅ 완전 지원 |

그 외 MCP 프로토콜을 지원하는 Agent도 수동 설정을 통해 사용할 수 있습니다.

**Q: 기존 프로젝트를 어떻게 마이그레이션하나요?**

**A:** 설치 명령어를 실행하기만 하면 됩니다:

설치 마법사가 다음을 수행합니다:
- 기존 설정 탐지
- `_omp/memory/` 디렉토리 생성
- IDE 설정 파일 생성
- 기존 파일을 덮어쓰지 않습니다.

**Q: 오래된 기억은 어떻게 정리하나요?**

**A:** 내장된 ROT 정리 명령어를 사용하세요:

이 명령어는 다음 항목을 식별하고 정리합니다:

**R**edundant (중복): 중복된 정보
**O**bsolete (구식): 업데이트되어 더 이상 유효하지 않은 오래된 정보
**T**rivial (사소함): 가치가 없는 확인용 문구

Now / Next / Later 패턴을 채택하여, 현재 방향에 집중하고 우선순위를 유연하게 조정합니다.

**성장 및 커뮤니티 구축**

- 콘텐츠 마케팅 — 페인 포인트(Pain Point) 관련 문서, 비교 영상, 사용 사례
- 커뮤니티 구축 — Discord/WeChat 그룹, 사용자 스토리 수집
- 문서 완성도 향상 — 트러블슈팅 가이드, 베스트 프랙티스(Best Practices)

**제품 경험 최적화**

- 설치 성공률 향상 — 더 나은 에러 메시지 및 자동 복구
- 첫 경험 최적화 — 5분 이내에 가치를 체감할 수 있도록 개선

- 기억 검색 강화 — 시맨틱 검색 (Semantic Search), 퍼지 매칭 (Fuzzy Matching)
- 일괄 기억 관리 — CLI 명령어를 통한 일괄 작업 지원
- 더 많은 IDE 지원 — Windsurf, Cline
- 기억 가져오기/내보내기 — 데이터 이식성 확보

- Web UI 관리 인터페이스
- 클라우드 동기화 옵션
- 기억 분석 및 인사이트

## 완료된 기능

**v2.0 - 멀티 에이전트 팀 지원 (Multi-Agent Team Support)**

- 🤝 멀티 에이전트 팀 기억 아키텍처 (Team Shared + Agent Private)
- 🎭 에이전트 ID 스키마 (Agent ID Schema) (행위자 귀속, 범위 필터링)
- 📋 팀 설정 파일 (`_omp/config.yaml`)
- 🔄 핸드오프 (Handoff) 워크플로우 (에이전트 간 작업 인계 프로토콜)
- 📁 스코프 지정 메모리 API (Scoped Memory API) (이중 계층 스코프 기억)

**v1.6 - xMemory 4계층 아키텍처**

- 🧠 xMemory 4계층 아키텍처 (L3 Theme → L2 Semantic → L1 Episode → L0 Message)
- 🎯 L3 테마 계층 자동 클러스터링 (흡착/분열/병합 알고리즘)
- 🔍 탑다운 (Top-down) 적응형 검색 (`--level theme`)
- ⚡ 테마 검색 CLI 옵션 (`--no-expand`)
- 📊 연결 성분 클러스터링 알고리즘 (Connected Component Clustering) (xMemory 논문 구현)

**v1.5 - 기초 기능**

- 이중 계층 기억 아키텍처 (프로젝트 레벨 + 사용자 레벨)
- 지능형 분류 라우팅
- 다중 IDE 지원 (Augment, Claude, Cursor, Gemini)
- CLI 설치 도구 (`npx openmemory-plus install`)
- 민감 정보 필터링
- 다중 LLM 프로바이더 (Provider) 지원 (DeepSeek, MiniMax, ZhiPu, Qwen, OpenAI, Ollama)
- Docker Compose 원클릭 배포
- 점진적 설정 (기존 파일을 덮어쓰지 않고 추가)
- MCP 자동 설정 및 검증

기여를 환영합니다! 참여 방법은 기여 가이드를 읽어주세요.

MIT License © 2026 TreeRen Chou

- OpenMemory (mem0) — 하위 기억 서비스
- Qdrant — 벡터 데이터베이스 (Vector Database)
- BGE-M3 — 다국어 임베딩 (Embedding) 모델
- MCP 프로토콜 — Model Context Protocol

Made with ❤️ for AI Agent developers