AVIDS2/memorix

Memorix – AI 코딩 에이전트를 위한 공유, 로컬 퍼스트 메모리 레이어

개요 – Memorix는 작업 중인 Git 저장소 내부에 검색 가능하고 버전 관리되는 메모리 저장소를 만드는 Node.js 라이브러리/CLI입니다. 저장소는 로컬 SQLite 데이터베이스(선택적 전체 텍스트 및 의미 인덱스 포함)에 저장되며, Model-Context-Protocol(MCP)을 이해하거나 플러그인/훅을 로드할 수 있는 모든 AI 기반 코딩 어시스턴트에 노출됩니다.

중요성 – 에이전트(Claude Code, GitHub Copilot CLI, Cursor 등)나 IDE, 터미널 세션을 전환할 때 각 도구는 일반적으로 빈 채팅 기록으로 시작합니다. Memorix는 에이전트가 동일한 프로젝트 전체의 사실, 설계 근거, 코드 스냅샷, 커밋 기반 지식을 공유할 수 있게 하여 동일한 컨텍스트를 다시 설명할 필요가 없습니다.

주요 기능

기능	제공 내용
메모리 오토파일럿	시작 파일, 현재 메모리, 검증 단계를 묶은 제한된 "워크셋" JSON.
관찰 메모리	현재 Git 리포지토리로 범위가 지정된 검색 가능한 사실, 수정 사항, 주의 사항, 세션 요약.
Git 메모리	커밋을 검색 가능한 엔지니어링 사실(무엇이 변경되었는지, 왜 중요한지)로 자동 수집.
추론 메모리	향후 참조를 위해 설계 결정, 대안, 트레이드오프를 저장.
코드 메모리 / 코드 그래프	버전 관리된 코드 스냅샷, TypeScript/JavaScript 심볼 수준 인덱싱, 신선도 확인.
지식 작업 공간	검토 게이트가 있는 Markdown 페이지와 자동으로 덮어쓰지 않는 표준 워크플로우.
오케스트레이션	다중 에이전트 작업, 핸드오프, 검증 루프를 조정하는 명령(memorix orchestrate, memorix lock, memorix team).
대시보드 및 HTTP API	메모리 탐색, 진단, 정리를 위한 로컬 웹 UI 및 선택적 HTTP 엔드포인트.
번들 터미널 에이전트 – memcode	동일한 Memorix 메모리를 읽고 쓰는 바로 사용 가능한 CLI 에이전트로, 빠른 프로토타이핑에 유용.
동기화	GitHub JSONL, S3, Postgres 등으로의 선택적 개인정보 필터 동기화 또는 MCP를 통한 다중 장치 공유.

작동 방식 – memorix init을 실행하면 ~/.memorix/config.toml(전역) 및/또는 <git-root>/memorix.toml(프로젝트)이 생성됩니다. memorix setup --agent <name>은 선택한 에이전트에 적절한 플러그인, 훅 또는 MCP 구성을 설치합니다. 핵심 서비스(memorix serve)는 stdio 기반 MCP 브리지를 실행하며, 별도의 memorix serve-http는 동일한 브리지를 HTTP를 통해 IDE나 다른 클라이언트에 노출할 수 있습니다.

일반적인 워크플로우

1. 설치 – npm install -g memorix
2. 초기화 – memorix init --global(기본값 생성)
3. 에이전트 연결 – 예: memorix setup --agent claude --global
4. 코딩 시작 – 에이전트는 이제 memorix memory 또는 memorix codegraph를 쿼리하여 이전 사실을 검색할 수 있고, memorix reasoning 또는 memorix ingest commit으로 새 관찰을 추가할 수 있습니다.
5. 오케스트레이션 – 더 큰 작업의 경우 memorix orchestrate을 실행하여 에이전트 간 작업 핸드오프, 파일 잠금, 검증 단계를 강제합니다.

지원 에이전트 – README에는 수십 개가 나열되어 있으며, Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor, Gemini CLI, Pi, Kiro, Antigravity, DeepSeek Harness, OpenClaw, Hermes Agent 및 MCP를 구현하는 모든 클라이언트가 포함됩니다.

설치 사전 요구 사항 – Node ≥ 22.18, Git(저장소 루트 찾기용), 의미 인덱싱을 위한 선택적 SQLite FTS5/LanceDB.

더 알아보기 – 저장소는 웹사이트, 중국어 README, 자세한 통합 문서(docs/INTEGRATIONS.md), 활성 작업 추적기(ACTIVE_WORK.md)에 대한 링크를 제공합니다.

---

위 정보는 모두 프로젝트 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.