Memroam

당신의 기억은 하나의 모델에 묶여 있어서는 안 됩니다. Memroam은 사용하는 모든 AI 에이전트(Claude Code, Codex, Cursor, ChatGPT 등)에게 하나의 공유되고 휴대 가능한 기억을 제공합니다. 한 하네스에서 규칙을 가르치고, 작업 중에 다른 하네스로 전환하면 정확히 중단한 지점부터 이어받습니다. 데이터베이스도, 임베딩도 없습니다. 당신이 소유한 일반 Markdown 파일이 하나의 명령으로 MCP를 통해 모든 에이전트에 연결됩니다. 당신의 기억은 당신과 함께 이동합니다.

Memroam은 사실을 일반 Markdown 파일로 저장합니다. 각 프로젝트는 격리된 메모리 공간을 가지며, shared/는 프로젝트 전반에 적용되는 사실을 보관합니다. 파일은 당신의 머신(또는 호스팅 티어의 경우 당신의 GitHub 저장소)에 남아 있으며, 모델이나 에이전트 하네스를 변경해도 완전히 사용할 수 있습니다 — 그것이 핵심입니다.

작동 방식

MCP 서버는 에이전트에게 여섯 가지 파일 작업(view, create, str_replace, insert, delete, rename)과 search(frontmatter와 본문에 대한 볼트 전체 키워드 검색)를 제공합니다.

에이전트는 작은 메모리 파일을 작성합니다. 각 공간의 MEMORY.md 인덱스는 변경 후 서버가 파일의 frontmatter에서 자동으로 생성합니다(직접 편집은 거부됩니다). 모든 새 메모리는 생성 시 불변의 UUIDv7 id:가 찍히며, create는 덮어쓰라고 명시하지 않는 한 기존 파일을 교체하지 않습니다. 데이터베이스나 임베딩 모델은 없습니다. Markdown 파일이 진실의 원천이므로 직접 읽고, 편집하고, grep하거나 버전 관리할 수 있습니다.

memory/
  MEMORY.md          # index of project spaces
  shared/
    MEMORY.md        # cross-project facts
    *.md
  <project>/
    MEMORY.md        # project index
    *.md

프로젝트 연결은 기본적으로 자체 공간을 읽고 쓰지만, 전체 볼트는 계속 보입니다. 다른 공간은 경로로 접근할 수 있고, 루트 목록에는 모든 공간이 표시됩니다. 범위는 라우팅 기본값이지 벽이 아닙니다. 범위가 없는 연결은 교차 프로젝트 유지 관리를 위해 볼트 루트에서 시작합니다.

Related MCP server: auxly-memory-cli

요구 사항

• Node.js 18 이상

• stdio(전역 설치) 또는 Streamable HTTP(저장소별 설치)를 지원하는 MCP 클라이언트

Memroam에는 런타임 종속성이 없습니다.

전역 설치(권장)

머신의 모든 하네스를 한 번에 연결하세요:

npx -y memroam install --global

감지된 각 하네스에 대해 사용자 수준의 stdio MCP 등록과 전역 규칙 파일에 메모리 의식을 작성합니다 — Claude Code (~/.claude.json + ~/.claude/CLAUDE.md), Cursor (~/.cursor/mcp.json), Codex (~/.codex/config.toml + ~/.codex/AGENTS.md), DeepSeek Harness (~/.dsh/AGENTS.md + 모든 프로필의 cordis.patch.yml에 stdio 마운트), OpenCode (~/.config/opencode/opencode.json + AGENTS.md), Gemini CLI (~/.gemini/settings.json + ~/.gemini/GEMINI.md), Antigravity (~/.gemini/config/mcp_config.json + ~/.gemini/config/rules/의 상시 활성 규칙). 그 후 모든 저장소의 모든 세션은 저장소별 설정 없이 볼트를 얻습니다. 하네스는 세션 디렉터리에서 memroam stdio를 실행하고, 서버는 해당 디렉터리에서 프로젝트 공간을 자동으로 파생합니다(가장 가까운 .git, 그렇지 않으면 가장 얕은 패키지 매니페스트; 표시가 없으면 default 공간). 규칙은 모든 하네스에 동일합니다. 서버 항목의 MEMORY_SPACE 환경 변수가 공간을 명시적으로 고정하거나, 클라이언트의 MCP 워크스페이스 루트가 이름을 지정하거나(세션 디렉터리 외부에서 MCP 서버를 실행하는 하네스의 경우), 그렇지 않으면 디렉터리가 결정합니다. 감지된 공간은 ~/.memory-vault-connections.json에 기록되어 안정적으로 유지됩니다.

npx -y memroam install --global --dry-run        # preview changes
npx -y memroam install --global --store <dir>    # choose the store (default ~/.memroam)
npx -y memroam uninstall --global                # undo exactly what install wrote

설치 후 세션을 다시 시작하세요. 저장소별 install(아래)은 팀 공유, 커밋된 구성 또는 사용자 지정 공간 이름을 위해 남아 있습니다. 이전 릴리스의 기존 ~/.memory-vault 저장소는 감지되어 유지됩니다 — 당신의 동의 없이는 아무것도 이동하지 않습니다.

저장소에 설치

연결하려는 저장소에서 다음을 실행하세요:

npx -y memroam install

이 명령은:

1. 로컬 서버가 이미 실행 중이 아니면 시작합니다.

2. 연결할 하네스를 묻고, 감지된 하네스는 미리 선택됩니다(대화형 터미널에서만 — 그 외에는 감지된 세트가 그대로 사용됩니다).

3. 선택한 각 하네스의 MCP 구성과 공유 규칙 파일을 작성합니다.

기본적으로 install은 메모리를 ~/.memroam에 저장하고(기존 ~/.memory-vault가 있으면 존중합니다) 현재 디렉터리에서 프로젝트 이름을 파생합니다. connect는 install의 별칭입니다.

npx -y memroam install --dry-run                # preview changes
npx -y memroam install --project my-app         # choose the project name
npx -y memroam install --harness claude,codex   # skip the prompt, pick explicitly
npx -y memroam install --yes                    # skip the prompt, accept detected

설치 후 에이전트 세션을 다시 시작하고, 메시지가 표시되면 vault MCP 서버를 승인하세요.

저장소에서 제거

npx -y memroam uninstall

install이 저장소에 작성한 모든 것(MCP 항목, 규칙 섹션, dsh 패치)을 제거하며, 파일이 다른 내용을 포함하지 않을 때만 삭제합니다. 당신의 기억은 절대 건드리지 않으며, 서버는 다른 프로젝트를 위해 계속 실행됩니다. disconnect는 uninstall의 별칭입니다.

연결 확인

npx -y memroam status

서버가 실행 중인지, 어떤 저장소를 제공하는지, 현재 저장소가 하네스별로 어떻게 연결되어 있는지, 그리고 install이 기록한 모든 저장소(~/.memory-vault-connections.json에 보관)를 표시합니다. 서버가 실행 중이고 저장소가 연결되어 있지만 에이전트 세션에 볼트 도구가 없다면, 남은 원인은 세션 연결입니다 — status가 해결 방법을 출력합니다.

네이티브 메모리 가져오기, 메모리 없는 하네스로 프로젝트

npx -y memroam import     # Claude Code auto-memory + Codex sqlite → candidates/
npx -y memroam project    # regenerate the read-only shared/ block in dsh's AGENTS.md

import는 각 하네스의 네이티브 메모리를 해당 공간의 candidates/ 디렉터리로 복사합니다 — 검색 가능하고 [candidate]로 표시되며, 인덱스에서 제외되고, 정식 메모리로 자동 기록되지 않습니다. Codex 리더는 읽기 전용이며 알 수 없는 데이터베이스 스키마 버전을 거부합니다. 두 명령 모두 이동할 수 있는 것과 없는 것에 대한 기능 보고서를 출력하며, --dry-run / --json을 지원합니다.

지원되는 하네스

DSH의 경우 생성된 패치로 세션을 시작하세요:

dsh --patch ./dsh-cordis.patch.yml --profile headless "your task"

호스팅 티어

호스팅 티어는 동일한 서버를 대신 실행해 주는 것입니다: OAuth 2.1로 보호되는 원격 MCP 엔드포인트로, 당신의 기억을 당신이 소유한 개인 GitHub 저장소에 커밋으로 저장합니다. Claude(claude.ai 사용자 지정 커넥터), ChatGPT(OpenAI 검색/가져오기 계약을 통한 사용자 지정 커넥터), Codex 또는 모든 원격 MCP 클라이언트에 연결하세요:

https://memroam.com/mcp

모든 기억은 저장소의 마크다운 파일입니다 — 복제하고, grep하고, 어디든 가져가세요. 호스팅 티어에 대한 접근을 잃어도 기억을 잃는 것은 아닙니다.

서버 직접 실행

MEMORY_DIR=~/.memroam npx memroam

서버는 기본적으로 127.0.0.1:8787에서 수신합니다.

복제된 저장소에서 npm start는 동일한 서버를 실행합니다.

MCP 엔드포인트

POST /mcp/<project>  project memory plus shared memory
POST /mcp            whole-vault access

예를 들어, 수동 Claude Code 연결은 다음과 같습니다:

claude mcp add --transport http --scope project vault http://localhost:8787/mcp/my-project

메모리 형식

Markdown 파일당 하나의 지속적인 사실을 저장하세요:

---
name: preferred-language
description: The project's preferred implementation language
---

Use TypeScript for new application code.

서버는 id:를 찍고 공간의 MEMORY.md 인덱스 줄을 description:에서 자동으로 다시 생성합니다. 에이전트에게 새 메모리를 만들기 전에 기존 메모리를 확인하고, 사실을 중복하지 말고 업데이트하며, 잘못된 메모리를 제거하도록 지시합니다.

현재 범위

현재 릴리스는 Markdown 저장소(로컬 폴더 또는 호스팅 GitHub 지원), 키워드 검색이 있는 MCP 인터페이스, 호스팅 티어의 OAuth 2.1, 교차 하네스 설정 명령, 일회성 가져오기/프로젝션 어댑터입니다. 자동 추출, 의미 검색, 자동 중복 제거는 없습니다.

패키지

• npm: memroam (이전 memory-vault)

• MCP 레지스트리: com.memroam/memroam

• 라이선스: MIT