Rememb

セッションをまたいでもコンテキストを失わずにAIエージェントを運用できます。rememb はローカルファーストの長期記憶です。構造化エントリ、キーワード検索、バージョン管理、差分、復元、監査証跡を備え、クラウドもAPIキーも不要です。

問題

エージェントを実務のスピードで活用しているチームがつまずくのは、生成能力が不足しているからではありません。毎日エージェントを運用することで、コンテキストの負債が生じるからです。

• セッションごとにプロジェクトの情報を何度も説明しすぎる
• チャットウィンドウの外に永続的な記憶がほとんどない
• 何かが変更された理由を追跡する監査証跡がほとんどない
• 適切なコンテキストを思い出す際にノイズが多すぎる

エージェントを専門的に運用するチームや個人開発者は、誰もがこの壁にぶつかります。

Session 1: "We're using PostgreSQL, auth at src/auth/, prefer async patterns."
Session 2: Agent starts from zero. You explain everything again.
Session 3: Same thing.

既存のソリューションは、ホスト型のメモリレイヤー、APIキー、または不透明なコンテキストパイプラインを中心にしていることがよくあります。 本当に必要なのは、必要最小限の正確なコンテキストと確認可能な履歴を保ちながら、次のセッションを再開することです。

rememb は、次の4つの記憶に関する課題を解決するように設計されています。

• セッション内だけのチャット記憶ではなく、永続的な事実や決定を保存する
• すべてを読み直すのではなくキーワードで検索する（関連性の判断はエージェントが行います）
• 気づかないうちに上書きするのではなく、非破壊的なバージョン管理を行う
• 不透明なクラウドログではなく、AIの作業に関するローカルファーストの監査証跡を残す

---

インストール

pip install rememb

---

クイックスタート

MCPを使う（推奨）

1. セットアップコマンドをインストールするか、MCPブロックを手動で追加します：

rememb install --apply --project

ホストが対応している場合（現在はCursorとClaude）、MCPサーバー、Memory Rules、SessionStart / PostToolUse / Stopフックを書き込みます。--apply を付けない場合は、実行計画を表示するだけです。--host を指定すると対象を絞れます。省略すると、rememb install が認識するすべてのホスト（cursor、claude、codex、vscode、copilot、windsurf、continue、gemini、opencode、zed、cline）に書き込みます。

または、IDEのMCP設定に次の内容を追加し、MCP_TOOLS.mdからルールを貼り付けます：

{
  "mcpServers": {
    "rememb": {
      "command": "rememb",
      "args": ["mcp"]
    }
  }
}

グローバルな ~/.rememb と並行してプロジェクトごとのストアを使用するには、繰り返し指定できる --project /path/to/repo 引数を追加します。詳しくはこちらをご覧ください。

2. IDEを再起動します。

SessionStartは、最近のエントリ、タグ、短い統計情報を挿入します。何か変更があった場合、エージェントは永続的な記憶を書き込み、対象を絞った想起が必要な場合にのみ検索します。

追加のストレージ設定は不要です。MCPモードでは、初回使用時にremembが ~/.rememb と、指定されている場合は --project ストアを自動的に初期化します。公開ツールについては、MCP_TOOLS.mdをご覧ください（18個のツール）。

同じマシン上の複数のMCPクライアントから、すでに実行中のremembプロセスを共有したい場合は、永続的なローカルSSEトランスポートを起動します：

rememb mcp --transport sse --host 127.0.0.1 --port 8765

MCPプロセスを1つ起動したままにするため、クライアントは http://127.0.0.1:8765/sse と http://127.0.0.1:8765/messages/ を通じて繰り返し接続できます。

stdio MCPクライアントの設定に --transport sse を含めないでください。stdio クライアントはstdin/stdout上のJSON-RPCを想定しています。SSEモードはHTTPエンドポイントを公開するため、別途起動する必要があります。

MCPを使わないローカル利用

rememb                    # Open the web UI (http://localhost:18181)
rememb --port 9000        # Custom port

---

仕組み

~/.rememb/                 ← default store location (MCP and Web UI)
  entries.json             ← default JSON backend (or entries.db with SQLite)
  meta.json                ← project metadata
  config.json              ← limits, sections, storage backend, UI paging

ディスク上のローカルストアです。エージェントは過去の決定事項を読み取り、キーワードやトークンで検索し、履歴を失うことなくエントリーを更新したり、クラウドのメモリサービスに依存せず以前のバージョンを復元したりできます。~/.rememb/ を任意の場所にコピーすれば、ストアを移動できます。

User: "We're using PostgreSQL, auth at src/auth/, async patterns"
Agent: [rememb_write] → Saved

[New session]
SessionStart injects recent + tags + stats (handoff first)
Agent: "I see you're using PostgreSQL with auth at src/auth/..."

書き込み、編集、削除は rememb_write、rememb_edit、rememb_delete を通じて行います。ホストフックも rememb hook post-tool / stop 経由で actions に書き込みます。MCP の全機能については、MCP_TOOLS.md をご覧ください。

検索では、エントリーの内容とタグを対象にキーワードとトークンのマッチングを行います。rememb_search は ID、スコア、タグ、日付、短い抜粋（search_excerpt_chars、デフォルトは 160 文字）を返します。全文を取得するには、エージェントが選んだ ID に対して rememb_get / rememb_read を使用するか、検索時に max_chars=0 を指定します。意味的な関連性の判断はエージェントが行います。API キーは不要で、クラウドも使用せず、実行時に埋め込みモデルをダウンロードする必要もありません。

config.json は初期化時に、サポートされているすべての設定項目を含めて書き込まれます。

{
  "max_content_length": 1000000,
  "max_tag_length": 500,
  "max_tags_per_entry": 100,
  "max_entries": 100000,
  "sections": ["project", "actions", "systems", "requests", "user", "context"],
  "section_colors": {
    "project": "#d84848",
    "actions": "#d08020",
    "systems": "#d4c430",
    "requests": "#40c040",
    "user": "#20d4c4",
    "context": "#c060f0"
  },
  "entry_batch_size": 24,
  "entry_load_threshold": 6,
  "search_excerpt_chars": 160,
  "storage_backend": "json"
}

大規模なストアでは、storage_backend を sqlite に設定します。バックエンドを切り替えても、Web UI と MCP が既存の JSON エントリーを自動的に移行します。

entry_batch_size と entry_load_threshold は、Web UI のページネーションを制御します。一度に読み込むカードの数と、「さらに読み込む」を表示するタイミングを指定します。

セクション名は小文字に正規化され、正規化後に重複する名前は無視されます。既存のエントリーがあるセクションを削除すると、そのエントリーは自動的に uncategorized に移行されます。meta.json は、現在有効なセクションの一覧と同期されます。

古いストアには、レガシーな埋め込み関連の設定キーが残っていることがあります。これらは、次回の設定読み込みまたは保存時に削除されます。

---

メモリセクション

セクション	保存する内容
project	技術スタック、アーキテクチャ、目標
actions	実施したこと、決定事項
systems	サービス、モジュール、連携機能
requests	ユーザーの好み、繰り返しの依頼
user	名前、スタイル、専門知識、好み
context	その他の関連情報

---

Web UI

rememb には、メモリの閲覧、履歴の確認、実行時設定の調整を行うための監視用ローカル Web インターフェースが含まれています。SPA には作成、編集、削除の操作機能はありません。HTTP API には引き続き、書き込み、削除、復元用のルートがあります。

rememb                       # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0        # Bind to all interfaces
rememb --port 9000           # Custom port
rememb --no-browser          # Start server without opening the browser

エントリー総数と最近のメモリのアクティビティを表示する概要画面。

合計、セクション別内訳、期間、最近のエントリーを表示する統計画面。

上限、ストレージバックエンド、セクションの色、メンテナンス操作の設定画面。

rememb に同梱されているエージェントスキルを閲覧する画面。

画面一覧：

• 概要 — エントリー総数、削除済み件数、ストアサイズ、最近のメモリ
• メモリ — 閲覧、キーワード検索、セクションによる絞り込み、並べ替え、削除済みエントリーの表示
• 統計 — 合計、バックエンド、セクション別バー、最古／最新のタイムスタンプ、最近のエントリー
• 設定 — 上限、ストレージバックエンド、セクションの色の編集、重複の統合、実行時設定の保存
• スキル — 同梱のエージェントスキルを閲覧（パッケージには 61 個のスキルが含まれます）

UI からエントリーを確認する際は、バージョン履歴と並べて表示する差分を確認できます。エントリーの変更や復元は、MCP（rememb_write、rememb_edit、rememb_delete、rememb_restore）または HTTP API で行い、SPA の操作機能では行いません。

---

CLI

rememb                                                      # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0 --port 18181 --no-browser            # Custom bind, no auto-open
rememb mcp                                                  # Start MCP server over stdio
rememb mcp --transport sse --host 127.0.0.1 --port 8765    # One persistent local MCP process
rememb hook session-start                                   # Inject recent + tags + stats
rememb hook post-tool                                       # Write a PostToolUse event from stdin
rememb hook stop                                            # Write a Stop/handoff entry from stdin
rememb install                                              # Show MCP + rules + hooks plan
rememb install --apply --project                            # Write them for the current directory
rememb --version, -v                                        # Show version
rememb --help, -h                                           # Show help

---

互換性

現在の互換性の範囲は、COMPATIBILITY.mdで明示的に管理されています。

概要：

• Python 3.11～3.14をCIでカバーしています
• CLIの契約とMCPツールスキーマ（18個のツール）は、自動テストでカバーされています
• stdio MCPが、主にドキュメントで案内されている統合方法です
• SSE MCPはドキュメント化されており、ルートレベルで部分的にテストされています
• リリースの自動化とTrusted Publishingについては、RELEASE.mdに記載されています

---

設計

• ローカル優先 — ディスク上のプレーンなJSONまたはSQLite
• ポータブル — ~/.rememb/をどこにコピーしても動作します
• 非依存 — あらゆるエージェント、あらゆるIDEに対応します（MCPまたはCLI）
• ロックインなし — サーバー、APIキー、アカウントは不要です

主な機能：

• セクションとタグを備えた構造化メモリー
• エージェント側で関連性を判断するキーワード検索（rememb_searchはインデックスです：id、score、excerpt。全文はget/readで取得します）
• ホスト連携：SessionStartで最近の項目＋タグ＋統計情報を注入し、PostToolUse / Stopでactionsに書き込みます。Stopではhandoffタグを付け、次のホストが最初に確認できるようにします
• rememb installでMCP、Memory Rules、フックを書き込みます（CursorとClaude用のフック）
• 非破壊的なバージョン管理、差分表示、復元、論理削除
• 重複の統合（完全一致する内容）とストアの統計情報
• Web UIによる設定とメンテナンス（設定と統合。エントリーの変更はMCPまたはHTTP API経由）
• Web UIとMCP経由で利用できる、同梱のエージェントスキル61個

---

コントリビューション

git clone https://github.com/LuizEduPP/Rememb
cd Rememb
pip install -e ".[dev]"

プルリクエストを歓迎します。Issueを歓迎します。スターも歓迎します。🌟

---

ライセンス

MIT