Memroam

あなたの記憶は、ひとつのモデルに閉じ込められるべきではありません。Memroam は、あなたが使うすべての AI エージェント（Claude Code、Codex、Cursor、ChatGPT など）に、ひとつの共有されたポータブルな記憶を提供します。あるハーネスで規約を教え、タスクの途中で別のハーネスに切り替えても、中断したところから正確に再開できます。データベースも埋め込みも不要です。あなたが所有するプレーンな Markdown ファイルを、ひとつのコマンドで MCP 経由ですべてのエージェントに接続します。あなたの記憶は、あなたとともに移動します。

Memroam は事実を通常の Markdown ファイルとして保存します。各プロジェクトには独立したメモリ空間が与えられ、shared/ にはプロジェクト横断で適用される事実が保持されます。ファイルはあなたのマシン上（またはホステッドティアではあなた自身の GitHub リポジトリ内）に置かれ、モデルやエージェントハーネスを変更しても完全に使用可能なままです。それがポイントです。

仕組み

MCP サーバーはエージェントに 6 つのファイル操作（view、create、str_replace、insert、delete、rename）と、フロントマターと本文を対象としたボールト全体のキーワード検索である search を提供します。

エージェントは小さなメモリファイルを書き込みます。各スペースの MEMORY.md インデックスは、変更のたびにサーバーがファイルのフロントマターから生成します（直接編集は拒否されます）。新しいメモリには作成時に不変の 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 ファイルごとに 1 つの永続的な事実を保存します：

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

Use TypeScript for new application code.

サーバーは id: を刻印し、description: からスペースの MEMORY.md インデックス行を自動的に再生成します。エージェントには、作成前に既存のメモリを確認し、事実を複製するのではなく更新し、不正確になったメモリを削除するように指示します。

現在のスコープ

現在のリリースは、Markdown ストア（ローカルフォルダまたはホステッド GitHub バック）、キーワード検索を備えた MCP インターフェース、ホステッドティアでの OAuth 2.1、クロスハーネスセットアップコマンド、およびワンショットのインポート/プロジェクションアダプタです。自動抽出、セマンティック検索、自動重複排除はありません。

パッケージ

• npm: memroam（旧称 memory-vault）

• MCP registry: com.memroam/memroam

• ライセンス: MIT