Robrain

RoBrain

チームと AI エージェントの共有メモリー — 判断力も備えています！

RoBrain は、単なるメモリーレイヤーではありません。あなたとエージェントがより良い判断を下し、コストのかかる失敗を避けられるよう支援する脳です。

自分の Postgres 上でセルフホストできます。受動的な記録、構造化された拒否事項、コーパス全体の矛盾スキャン — 何もマシンの外に出ません。Claude Code、Cursor、GitHub Copilot (VS Code)、Codex CLI、Hermes などに対応しています。

測定結果：判断の記憶がない場合、コーディングエージェントは、チームがすでに却下したアプローチを、最大 10 件中 9 件 のタスクで再提案します。RoBrain の完全なパイプラインを通すと、アーカイブされた 5 回の実行全体で 50 件中 0 件 です — VetoBench。

概要

RoBrain は、チームとそのエージェントが下した決定と、却下した代替案を、誰も手作業でタグ付けすることなく記録します。Sensing がセッションのやり取りを取得し、Perception が各決定を Postgres に抽出します。各行には構造化された rejected[] フィールドを含めることができます。

ほとんどのエージェントメモリーツールは、取得したところで止まります。起きたことを保存し、後で検索されることを期待します。RoBrain は判断力を加えます。バッチ Synthesis がコーパス全体を読み込み、矛盾、見解の変化、単一のセッションでは見つけられない繰り返し登場するエンティティにフラグを立てます。

重要なのは引き継ぎです。ある人が火曜日に Cursor で意図的に判断を下します — たとえば、Perception を Express に移植せず Hono のままにすることです。水曜日に新しいチームメンバーが、その判断を知らずに Claude Code を開き、まさにその変更を求めます。RoBrain は、エージェントがすでに却下した方針へ進む前に、記録された根拠を提示します — 同じ Postgres ストア、同じ拒否事項、受動的な記録。

却下したことを忘れるコストは、非効率ではありません。すでに修正した認証バイパス、すでにロールバックしたマイグレーション、CVE のためにすでに削除した依存関係 — 「いいえ」と言った理由を知らないエージェントが、再び提案してくることです。

コーディングが最初の対象分野なのは、フィードバックループが短く、元に戻す作業、インシデント、やり直しによって、却下したことを忘れるコストを測定できるためです。同じアーキテクチャは、エージェントがセッションを超えて残る決定を下すすべての場面に適用できます。

仕組み、2 つの柱（記録と判断）、および詳しい解説については、docs/concepts.md をご覧ください。

インストール

RoBrain の実行方法は 2 つあります — どちらかを選んでください。

• オプション 1 · セルフホスト（無料、オープンソース）：すべてが自分のマシン上で動作します — 自分の Postgres、自分の API キーを使用し、ノート PC の外に何も出ません。
• オプション 2 · Rory Plans クラウド（マネージド）：ホストするものもキーも不要です — 有料の Rory Plans プランすべてに含まれています。

オプション 1 · セルフホスト（無料、オープンソース）

クローンは不要です。robrain up を実行すると、公開済みの Perception イメージが取得され、認証情報が ~/.robrain/stack/.env に生成されます。

デフォルトの構成では、Anthropic（抽出）と OpenAI（埋め込み）を使用します。その他の構成（OpenAI のみ、Gemini、別の埋め込みモデル、完全ローカル）については、概念 — 別のプロバイダー構成を利用する場合をご覧ください。

export ANTHROPIC_API_KEY=... OPENAI_API_KEY=...   # or add them to ~/.robrain/stack/.env after the first run
npx robrain@latest up                             # start Postgres + Perception from ghcr.io
npx robrain install --self-hosted                 # wire Sensing MCP into your editors

git clone https://github.com/adelinamart/robrain
cd robrain
pnpm install && pnpm build
pnpm docker:up                 # first run: creates .env; Perception won't start yet
# open .env, add LLM + embedding keys for the provider path you chose (default: ANTHROPIC_API_KEY + OPENAI_API_KEY)
pnpm docker:up                 # second run: Perception now boots
pnpm robrain install --self-hosted --repo-root "$(pwd)"

Claude Code プラグイン（セルフホスト）

セルフホストのスタックを利用する Claude Code ユーザーは、フックベースのキャプチャと、以前却下したアプローチについてタスク開始前に警告する機能を追加できます。CLAUDE.md のプロトコルは必要ありません。

claude plugin marketplace add adelinamart/robrain
claude plugin install robrain@robrain

詳細は plugins/claude-code をご覧ください。robrain init-project は、プロジェクトの .claude/settings.json を通じて共同作業者にもプラグインを推奨するため、チームメイトには Claude Code 自体からインストールの案内が表示されます（--skip-claude-plugin で無効にできます）。

オプション 2 · Rory Plans クラウド（マネージド）

有料の Rory Plans プランであれば、ホスティング環境を用意せずに RoBrain を利用できます。

npx robrain install          # no flags — cloud mode

roryplans.ai にサインインし、プロフィールページで API トークンを作成して、インストーラーの案内に従って貼り付けてください。これだけで設定は完了です。Docker、データベース、LLM や埋め込みモデルのキーは不要です。抽出と検索は当社側で実行されます。エディター（Claude Code、Cursor、Copilot、Codex CLI）は自動的に連携され、Rory Plans チームのチームメイト同士で同じメモリーを共有できます。

すべての有料プランが対象です。個人向けの標準プランまたは年間プラン、Teams、エンタープライズが含まれます。個人の契約者はプライベートなメモリースペースを利用でき、チームでは共有できます。セルフホストは引き続き無料で、全面的にサポートされています（上記の「インストール」を参照）。各プランで利用できる内容は、比較表をご覧ください。

クイックスタート

セルフホストまたはクラウドのいずれかをインストールした後：

# Wire capture into an application project (run inside the repo)
cd /path/to/your/project
npx robrain init-project          # writes CLAUDE.md, AGENTS.md, .cursor/rules/robrain.mdc

# Capture and recall are automatic from here:
#   - every session turn is classified, no tagging
#   - prior decisions load at session start via the always-on summary

# Explain any file's decision history
npx robrain explain path/to/file

# Inspect / approve captured rows (both modes)
npx robrain review

# Run corpus judgment — self-hosted only; cloud runs judgment server-side
npx robrain synth                 # drift, contradictions, entity promotion

init-project の後、すべてのリポジトリに CLAUDE.md と AGENTS.md（Codex CLI 用）が作成されます。また、Cursor には alwaysApply: true を含む .cursor/rules/robrain.mdc も作成されます。キャプチャが保存されない場合は、npx robrain doctor を実行してください。詳しくはトラブルシューティングをご覧ください。

キャプチャ対象を調整する

デフォルトでは、分類器は決定事項と却下した代替案を保存し、それ以外は保存しません。プロジェクトでより多く、より少なく、または別の内容を保存したい場合は、自然な言葉で指示してください。設定は Perception 上でプロジェクトごとに保存されるため、すべてのチームメイトのセッションで同じ方法でキャプチャされます。

npx robrain capture show
npx robrain capture set --instructions "Skip anything about the marketing site. Treat naming conventions as decisions."
npx robrain capture set --min-confidence 0.75                      # less noise
npx robrain capture set --mode broad                               # every turn reaches the model, not only keyword hits
npx robrain capture set --add-kind "run: The outcome of an agent run: what ran, when, and whether it succeeded."
npx robrain capture test --file sample-turns.jsonl --compare       # dry run before you commit to it

追加の種類のメモリーは、決定事項と並んで保存されます。各エントリーには対象が記録され、同じ対象について新しいエントリーが作成されると古いものが置き換えられます。そのため、ルールだけでなく、変化する状態（エージェントの前回実行など）も保存できます。拒否権を持つのは決定事項だけです。フラグと形式については、CLI リファレンスをご覧ください。

シンセシス

シンセシスでは、decisions テーブル全体に対して3つのパスを実行します。ドリフト（明示的な撤回なしに立場が変化すること）、矛盾（異なるセッションでの相容れない決定）、エンティティの昇格（繰り返し登場するツールやパターンをまとめて planning_blocks に格納すること）です。データベースにフラグとエッジを書き込みますが、新たな決定を記録するのではなく、すでにあるコーパスを評価します。

pnpm synthesis:build && pnpm synthesis:run
# or: npx robrain synth

検出された内容は npx robrain review で確認できます。詳しい解説（3つのパス、cron、環境変数）については、コンセプト — シンセシスをご覧ください。

エディター連携

1つのツール横断セットアップで、Claude Code、Cursor、GitHub Copilot（VS Code）、Codex CLI を同じ Postgres ストアに接続できます。分類に使う LLM は、Anthropic Haiku または OpenAI から選べます。決定にはライフサイクル（active / superseded / invalidated）とグラフ（conflicts_with / extends / related_to）があります。

Codex CLI / IDE では、フックベースの記録とタスク開始前の拒否警告も利用できます。Claude Code プラグインと同じライフサイクルフックが、robrain install によって ~/.codex/config.toml に自動設定されます（初回実行時、Codex から信頼するか確認されます）。ドキュメント：plugins/codex。

Hermes を実行していますか？ npx robrain install --hermes を実行すると、スタンドアロンのメモリプロバイダープラグインが ~/.hermes/plugins/ に配置され、同じ Perception API を通じて受動的な記録と、拒否を考慮した想起が行われます。ドキュメント：integrations/hermes。

Git 用の決定ログ（オプトイン）：

npx robrain export-memory --ledger
# custom path: npx robrain export-memory --ledger docs/decisions.md

よくある質問

チームがすでに却下した案を、AI コーディングエージェントが再提案しないようにするには？

却下したことを一度記録するだけでかまいません。RoBrain は、却下が行われたセッションからその内容を受動的に取得します。その後、接続されたすべてのエージェントが同じ方向へ進もうとする前に、拒否警告を受け取ります。警告には、決定、却下された選択肢、元の理由が含まれます。エディター連携とClaude Code プラグインをご覧ください。

Claude Code、Cursor、Copilot、Codex の間でメモリを共有するには？

npx robrain install --self-hosted を実行すると、検出されたすべてのエディターが同じ Postgres ストアに接続されます。npx robrain init-project は、リポジトリを一度登録するだけです。火曜日に Cursor で行われた決定は、水曜日にはチームメイトの Claude Code に届きます。

データはファイルとデータベースのどちらに保存されますか？ また、マシンの外部に送信されますか？

すべてのデータは PostgreSQL（埋め込みには pgvector を使用）に保存されます。フラットファイルではなく、構造化された行として保存されます。セルフホストの場合、データベースはお使いのマシン上の Docker で実行され、設定した LLM／埋め込みプロバイダーへの呼び出しを除き、データが外部に送信されることはありません（ローカルモデルも使用できます）。Rory Plans クラウドでは、抽出された決定オブジェクトのみが保存され、抽出後の会話の生テキストは保持されません。

RoBrain はベクトルデータベースや RAG とどう違いますか？

ベクトルストアが取得するのは「類似した」情報です。RoBrain は「却下された」内容も把握します。却下内容は、構造化された第一級データ（rejected[]）として保存され、エージェントが行動する前に警告として提示されます。また、コーパスを積極的に評価します。矛盾のスキャン、ドリフトの検出、そして現実がすでに覆した決定を退ける git の結果フィードバックを行います。その違いは VetoBench で測定できます。

セルフホストではなく Rory Plans クラウドを使うのはどんな場合ですか？

すべてを自社のインフラ上で無料で運用したい場合は、セルフホストしてください。ホスティングも API キーの管理も不要にしたい場合は、Rory Plans クラウドを選んでください。有料の Rory Plans プランすべてに含まれており、チームの組織全体でメモリを共有できます。

RoBrain と Rory Plans の関係は？

Rory Plans は、人間と AI エージェントのためのクラウドオフィスです。ワークフローを設計し、人間とエージェントを連携させます。RoBrain はそのオープンソースのメモリレイヤーです。単体で利用でき、いつまでもセルフホスト可能です。また、チーム向けには Rory Plans の一部として管理されます。

他のツールとの比較

Mem0、Cloudflare Agent Memory、Claude Code Auto-Memoryと比べて、RoBrainだけが却下した代替案を構造化フィールドとして保存し、コーパス全体を対象に矛盾をスキャンします（手動または cron）。この違いがもたらす影響も測定しました。VetoBenchでは、同一の入力に対するMem0の取り込みで、記録された却下が取得コンテキストに含まれる割合は**38%**にとどまりました。比較の詳細 →

セルフホストとRory Plansクラウドの比較

セルフホストでは、記録、判断のバッチ処理、結果のフィードバック、セッション開始時の想起を利用でき、必要に応じてinjectで絞り込んだコンテキストを取得します。クラウドではPlanning + Controlが加わり、タスク境界で拒否事項と競合が自動的に提示されます。CLIのインターフェースは同じで、Sensingによる記録とワイヤー互換です。詳細：コンセプト — 無料／セルフホストとRory Plansクラウド。

VetoBench

メモリのベンチマークでは通常、「正しい項目が呼び出されたか」を尋ねます。VetoBench が問うのは、そこからは見えてこない点です。チームがすでに却下したアプローチを促すタスクを与えられたとき、エージェントはそのアプローチを再び提案するでしょうか？

（claude-haiku-4-5、2026-07-07/08。各条件は、5 回の実行をアーカイブした一連の測定として評価しています。実行ごとにばらつきがあるため、範囲で示しています。Mem0 と RoBrain にはバイト単位で同一のトランスクリプトを取り込み、それぞれ実際の本番環境で使われている抽出処理に通しました。）

この表の背景には 2 つの知見があります。Mem0 の取り込み処理では、記録された却下の内容が取得されたコンテキストの 38％から脱落し、違反はまさにその場合に集中しました。拒否内容がない場合は 26％、ある場合は 3％でした。エージェントは 5 回すべての実行で Express を避けましたが、その理由は一度も説明できませんでした。一方、axios の拒否内容が失われた場合は、5 回中 3 回で axios を再提案しました。同じ入力に対する RoBrain の本番用抽出器は、100 件すべての拒否内容を保持しました。拒否内容を残すのは抽出プロンプトの役割であり、事実を要約した結果としてたまたま残るものではありません。

Meta Muse Spark 1.1（2026-07-14、5 回の実行をアーカイブ）。 Vercel AI Gateway 経由で、Meta が新たに公開したエージェント型のフラッグシップモデルを評価しました。メモリなしでは、実行ごとに 9 タスク中 4～6 件で却下されたアプローチを再提案しました。Redux、Prisma、Jest、GraphQL は 5 回すべての実行で再提案されました。RoBrain の意思決定メモリを使用した場合は、45 セルすべてで違反が 0 件となり、毎回、以前の却下内容を明示しました。詳しく説明した箇所では、記録された理由と日付を一言一句そのまま引用しました。最も明確な例では、モバイルの過剰なデータ取得を減らすよう求めたところ、メモリなしの実行では、チームが却下していたアプローチである GraphQL の全面導入を、5 回中 5 回提案しました。RoBrain のコンテキストを与えると、REST のスパースフィールドセットを提案し、記録された却下内容を引用しました。正確を期すための注記です。これは Muse Spark 固有の問題ではありません。同じ 9 つのシナリオでは、ベースラインとして評価したすべての最先端モデルが、メモリなしで違反しています（claude-opus-4.8：3～4 件、gpt-5.5：5 件、gemini-3-pro-preview：6～7 件、Haiku：7～8 件。Prisma と Jest はすべてのモデルのすべての実行で提案されました。一方、RoBrain のコンテキストを与えた同じ 3 モデルでは、54/54 セルで違反が 0 件となり、4 ベンダー合計では 99/99 でした — 検証データ）。また、今回のコーパス規模では、簡素な規約ファイルでもこのモデルの違反を防げました（RoBrain との差は、一言一句そのままの引用と推測との違い、自動記録、そして大規模な検索にあります）。さらに、Meta のコンテンツフィルターが無害なセッションキャッシュのプロンプトを確定的にブロックするため、1 つのシナリオは除外しています（n=9）。検証データと注意事項：results/muse-spark-1.1-series/ · 解説：docs/blog/2026-07-14-muse-spark-forgets-your-vetoes.md。

取得されたすべてのコンテキスト、エージェントの返信、判定は packages/vetobench/results/ にコミットされています。引用する前に、内容をご確認ください。検索レイヤーは API キーなしでオフライン実行でき、CI でチェックされます（pnpm --filter @robrain/vetobench bench）。判定は決定論的で、LLM による判定はありません。どのメモリシステムも、単一のアダプターインターフェースを通じて接続できます。こちらに不利な結果となるものも含め、プルリクエストを歓迎します。手法、正直さを期すための注意事項、フィクスチャ：packages/vetobench/README.md。

セキュリティ

メモリーコーパスは PERCEPTION_API_KEY で保護されています。これはリポジトリルートの .env にあるランダムなシークレットで、すべてのクライアント（Sensing MCP、CLI、Synthesis）が Bearer トークンとして送信し、Perception は /health を除くすべてのリクエストでこれを検証します。サービスから発行されるものではありません。初回実行時に pnpm docker:up が自動生成するか、独自に設定してください（例：openssl rand -hex 32）。インストール（クローンから実行する場合は pnpm robrain install --self-hosted、それ以外の場合は npx robrain install --self-hosted）により、クライアントが認証できるよう、同じ値がエディターの設定にもコピーされます。

Perception はキーが空の場合、起動を拒否します。認証なしで実行するには、明示的なオプトインが必要です。キーなしで実行していたバージョンからアップグレードする場合： .env にキーを追加する（または pnpm docker:up を再実行して自動入力する）とともに、エディターに反映させるためインストールを再実行してください（クローンから実行する場合は pnpm robrain install --self-hosted、それ以外の場合は npx robrain install --self-hosted）。詳細とオプトイン用のフラグは .env.example に記載されています。

デフォルトで有効になっている機能は、シークレットの編集（API キー、トークン、秘密鍵、接続文字列のパスワードは、キャプチャ時とインジェスト時に再度、埋め込みや保存の前に除去されます）と、抽出および埋め込みを OpenAI 互換のローカルサーバー（Ollama / LM Studio / vLLM）で実行する完全ローカルモードです。CLI — 完全ローカル LLM と .env.example を参照してください。

次の予定

robrain outcomes は、Git のリバートを両方の階層でメモリーの品質に反映します。次はこれをインシデントとサイクルタイムに広げ、チームが自らのコードベースで誤った目標に向けて最適化している場合に、RoBrain がそれを明らかにできるようにする予定です。

要件

• Docker + Docker Compose（Postgres と Perception をローカルで実行）
• pnpm を備えた Node.js（ビルドと CLI）
• 分類器用の LLM キー（Anthropic Haiku または OpenAI）、または ローカルの OpenAI 互換サーバー（完全ローカル LLM を参照）
• 埋め込み用のキー（例：OpenAI）、または埋め込みにも同じローカルサーバー
• セルフホストモードでは、データがマシンの外に送信されることはありません

ドキュメント

• 概念（仕組み、2 つの柱、Synthesis、比較）→ docs/concepts.md
• CLI リファレンス（explain、インストール、アップグレード、エディターの設定、全コマンド一覧）→ docs/cli.md
• 完全ローカル LLM（Ollama / LM Studio / vLLM、クラウドキー不要）→ docs/cli.md#fully-local-llm-ollama--lm-studio--vllm
• メンテナー向けリリースチェックリスト（タグ → GHCR → npm → MCP レジストリ）→ docs/release.md
• トラブルシューティング（応答のない 401、Docker の再ビルド、古い要約、ローカル LLM）→ docs/troubleshooting.md
• メモリー交換フォーマット（robrain export、robrain-memory/v1 JSONL）→ docs/memory-interchange.md
• VetoBench（メモリーは却下された再提案を阻止できるか？ 方法論 + アーカイブ済みの記録）→ packages/vetobench/README.md
• Claude Code プラグイン（フックベースのキャプチャ + 拒否警告）→ plugins/claude-code/README.md
• Codex CLI フック（同じライフサイクルフックを robrain install で設定）→ plugins/codex/README.md
• eve メモリープロバイダー（@robrain/eve — eve の memory-provider コントラクトを介した、Vercel の eve エージェント向けチーム意思決定メモリー。eve 0.82.0 で検証済み）→ packages/eve/README.md
• eve raw-surfaces インテグレーション（動的な指示、拒否ツール、キャプチャフック。eve のメモリーサブシステムより前に開発）→ plugins/eve/README.md
• Hermes エージェントプラグイン（memory-provider、キャプチャ + 拒否警告）→ integrations/hermes/robrain/README.md

コントリビューション

Apache 2.0。抽出精度、新しいエディター連携、埋め込みプロバイダーに関する PR を歓迎します。トレードオフとスキーマについては、概念 — リファレンス を参照してください。

License

Apache 2.0 — see LICENSE

Built by Rory Plans