Renor

Renor

セルフホストの Renor の実際のセッションです。Claude Code が決定事項を保存し、新しい Codex セッションがそれを呼び出します。待ち時間は早送りされています。

Renor はコーディングエージェント向けのメモリです。Claude Code、Codex、Cursor に伝えたことを、マシン上の Markdown ファイルのフォルダーに保存し、MCP を通じてどのエージェントにも返します。

新しいエージェントのセッションは、毎回ゼロから始まります。プロジェクトや先週の決定事項とその理由、二度修正したことを、改めて説明する必要があります。Renor を使えば、あるエージェントが保存した内容を、次のエージェントが見つけられます。メモリは、あなたが所有するプレーンなファイルです。ローカルで動作し、アカウントや API キーは不要です。モデルを設定しない限り、マシンの外にデータが送信されることはありません。インストール不要のホスト版は https://renor.cloud で利用できます。

クイックスタート

必要なのは Node 22 と git です。インストール時のみネットワーク接続が必要です。

git clone https://github.com/patrickpassosb/renor-engine.git
cd renor-engine
node -v                    # must print v22.x
npm ci && npm rebuild better-sqlite3 --ignore-scripts=false && npm run build
node scripts/smoke-self-hosted.mjs

最後のコマンドは MCP サーバーを起動し、1 件の情報（Ada favorite_color cerulean）を保存して、3 通りの方法で検索した後、停止します。後で削除する一時フォルダー内で動作するため、メモには一切触れません。最後に次のように表示されます。

PASS: self-hosted stdio MCP can remember and retrieve a current fact.

git clone ではなく ZIP をダウンロードしましたか？ビルドに使う git の履歴が含まれていないため、代わりに RENOR_BUILD_COMMIT=0000000 npm run build でビルドしてください。Node のバージョンが異なる場合や、インストールスクリプトを実行しなかった場合は、トラブルシューティングを参照してください。

エージェントを接続する

クローンなしで。 Node 22 がインストールされていれば、1 行で公開済みパッケージを登録できます。メモはホームディレクトリの隠しフォルダー（~/.renor。起動時に stderr に表示されます。既存の renor フォルダーは再利用しません）に保存されます。別のフォルダーを使うには、claude の行に -e VAULT_PATH=/absolute/path を、または codex の行に --env VAULT_PATH=/absolute/path を追加してください。初回起動時は約 130 MB をダウンロードし、約 15 秒かかります。エージェントに接続失敗が 1 件表示された場合は、再起動してください。

claude mcp add --scope user renor-local -- npx -y renor-engine mcp
codex mcp add renor-local -- npx -y renor-engine mcp

Cursor やその他のクライアントでは、サーバーは引数 -y renor-engine mcp を指定したコマンド npx です。claude mcp remove renor-local と codex mcp remove renor-local を実行すると登録を解除できます。このセクションの残りはクローンから同じ設定を行う方法で、コードの変更もできます。

クローンから。

メモリ用のフォルダー（新規の空フォルダーでも、Obsidian の保管庫でもかまいません）を選び、インデックスを作成します。同じシェルで renor-engine ディレクトリに移動して、以下を実行してください。

export VAULT_PATH="$HOME/renor-notes"    # absolute path; created if missing
node dist/cli.js index

以下の各コマンドは、現在使用している Node 22（node -p process.execPath）で Renor を起動するため、エージェント側の PATH に Node 22 がなくてもかまいません。新しいターミナルを開いた場合は、最初に export の行をもう一度実行してください。各コマンドは、起動できないサーバーを登録してしまわないよう、VAULT_PATH: run the export line above first というメッセージで停止します（エージェント側では単に「Connection closed」と表示されます）。

Claude Code

claude mcp add --scope user renor-local -e VAULT_PATH="${VAULT_PATH:?run the export line above first}" -- "$(node -p process.execPath)" "$PWD/dist/cli.js" mcp

Claude Code を再起動すると、すべてのプロジェクトで /mcp に renor-local が表示されます。claude mcp remove renor-local を実行すると登録を解除できます。

Codex

codex mcp add renor-local --env VAULT_PATH="${VAULT_PATH:?run the export line above first}" -- "$(node -p process.execPath)" "$PWD/dist/cli.js" mcp

Codex を再起動すると、codex mcp list に表示されます。codex mcp remove renor-local を実行すると登録を解除できます。

Cursor

Cursor は ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）から MCP サーバーを読み込みます。次のコマンドでエントリーを表示できます。

VAULT_PATH="${VAULT_PATH:?run the export line above first}" node -e 'console.log(JSON.stringify({ mcpServers: { "renor-local": { command: process.execPath,
  args: [process.cwd() + "/dist/cli.js", "mcp"], env: { VAULT_PATH: process.env.VAULT_PATH } } } }, null, 2))'

これを該当ファイルに追加するか、既存の mcpServers に renor-local のエントリーを統合し、Cursor の MCP 設定で renor-local が有効になっていることを確認してください。（このリポジトリの cursor-plugin/ フォルダーは、Renor アカウントが必要な renor.cloud のホステッドサービス用 Cursor プラグインであり、このエンジンには接続しません。）

その他の MCP クライアント： コマンドは VAULT_PATH を設定した node dist/cli.js mcp（stdio）です。

エージェントに何かを記憶させ、新しいセッションでそれについて質問してください。エージェントが保存した内容は、すぐに検索できます。手動で追加または編集した Markdown ファイルは、node dist/cli.js index をもう一度実行すると検索可能になります。

保存先

内容	保存先
メモ	$VAULT_PATH 内の任意の Markdown ファイル。Renor が読み込みます。どのツールでも編集できます。
エージェントが保存した内容	同じフォルダー内に Markdown として追記されます。事実は System/Memory Events Ledger.md に、メモは Memory/Daily/<date>.md に保存されます。
検索インデックス	$VAULT_PATH/.semantic-memory/index.db の SQLite。派生データです。node dist/cli.js index を実行すると、Markdown から再構築されます。

Renor が保持するものはすべてこの 1 つのフォルダーにあるため、ほかのフォルダーと同じようにバックアップ、同期、移動ができます。モデルキーを設定しない限り、データがマシンの外に出ることはありません。EMBEDDING_PROVIDER=openai を設定すると、メモのテキストが OpenAI に送信されて埋め込み表現が作成されます。また、エビデンスモデルのキー（RENOR_EVIDENCE_API_KEY または OLLAMA_* キー）を設定すると、検索で一致したメモがそのモデルに送信されます。シェルですでにそのようなキーをエクスポートしている場合は、サーバーの登録時に -e RENOR_EVIDENCE_MODE=off を追加してください（Codex の場合は --env）。各設定とデフォルト値については、docs/ENVIRONMENT-VARIABLES.md を参照してください。

埋め込みなしで検索する。 何も設定しない場合、Renor は埋め込みモデルを使用しないため、メモは完全一致する単語で見つかります。blue notebook で「The blue notebook is on the desk」は見つかりますが、where is my notebook? では見つかりません。保存された事実は、どちらの場合も見つかります。意味に基づいて検索するには、OPENAI_API_KEY とともに EMBEDDING_PROVIDER=openai を設定するか、local を設定してモデルを一度ダウンロードし、このマシン上で実行してください。その後、node dist/cli.js rebuild を実行して、既存のメモを埋め込みます（詳細）。

詳細

• docs/self-hosting.md：トラブルシューティング、埋め込み、OAuth サインイン対応の HTTP サーバー、HTTP 経由でのエージェント接続、ツール一覧、所有者名、複数エージェント（「ハイブ」）ツール（エージェントごとに RENOR_CONNECTION_NAME を設定）、およびボルトの保護方法について説明しています。
• skill/SKILL.md：指示されなくても記憶を呼び出して保存するよう、エージェントに与える指示です。その大半ではホスト型ツール（get_context、remember）を紹介しています。上記の renor-local サーバーでは別の名前（search、remember_fact、note）が使われており、Stdio セクションに記載されています。

Renor は単一の所有者向けエンジンです。1 人分のメモと 1 組のエージェントを扱います。マルチユーザー向けの製品ではありません。

貢献、ライセンス、セキュリティ

貢献を歓迎します。CONTRIBUTING.mdでは、セットアップとテストについて説明し、初めての貢献に適した課題を紹介しています。Renor 独自のコードはAGPL-3.0-only（LICENSE）でライセンスされています。上流プロジェクトから取り込んだファイルは ISC のままです（NOTICE、UPSTREAM.md）。脆弱性は公開 issue ではなく、SECURITY.mdの説明に従って非公開で報告してください。