TL;DR

Memorix는 MCP를 중심으로 여러 AI coding agent가 하나의 Git 프로젝트 기억을 공유하게 하는 TypeScript 기반 MCP server이자 CLI tool입니다. SQLite에 관찰 기록과 reasoning, Git Memory, code 상태를 저장하고 Orama로 검색하며, `memorix context`와 `memorix resume`가 작업에 필요한 기억만 제한적으로 주입합니다. Claude Code, Codex, Cursor, Windsurf, Gemini CLI, OpenCode 등 다양한 생태계에 `setup` 명령으로 MCP·plugin·rules·hooks·skills를 연결할 수 있습니다. 로컬 full-text retrieval은 모델 키 없이도 작동하지만, 장기 기억 검토와 agent별 설정 관리까지 포함해 단순한 MCP memory 저장소보다 운영 범위가 넓습니다.

핵심 포인트

• MCP server와 CLI를 함께 제공하는 TypeScript 기반 cross-agent memory layer입니다. SQLite를 정본 저장소로 사용하고 Orama 검색을 붙여 프로젝트별 기억을 Git 프로젝트 아래에 보관합니다. Claude Code, Codex, Cursor, Windsurf, Gemini CLI 등 MCP나 hooks, rules, plugin을 지원하는 coding agent를 바꿔도 같은 프로젝트 기억을 이어갈 수 있습니다.
• 기억은 관찰 기록, reasoning, Git 변경 내역, code 상태, 검토된 장기 기억으로 나뉩니다. `memorix context`가 작업 유형에 맞는 파일과 기억을 Workset으로 압축하고, `memorix resume`가 최근 세션과 검토된 durable anchor를 제한적으로 복원합니다. LLM 키가 없어도 local full-text retrieval이 작동하며 embedding은 설정된 경우에만 의미 기반 보조 검색으로 사용됩니다.
• `memorix setup --agent <agent> --global`이 대상 agent에 맞춰 MCP, plugin, extension, rules, hooks, skills 설정을 설치합니다. `memorix serve`는 기본 `micro` 모드의 stdio MCP를 제공하고, `memorix background start`는 dashboard와 여러 클라이언트를 위한 HTTP endpoint를 엽니다. 여러 worker를 쓰는 `memorix orchestrate`는 `.worktrees/`에 작업 공간을 만들고 handoff, file lock, verification, review loop를 조정합니다.
• 전역 설치에는 Node.js `>=22.18.0`과 Git이 필요하고 Apache 2.0 라이선스를 사용합니다. 기본 메모리 기능은 로컬 SQLite에 의존하지만 LLM formation, embedding, MiniMax media generation을 켜면 외부 provider 설정과 비용 관리가 추가됩니다. 기능 범위가 MCP memory를 넘어 agent 설치, Git ingestion, dashboard, SDK, bundled terminal agent까지 넓어 초기 설정과 운영 표면이 단순한 memory plugin보다 큽니다.