AIエージェントが長期的な知識を編集可能なファイルとして保存、検索、統合できる、ローカルファーストのMarkdownメモリワークスペース。
oleksiijko/pmb
Claude Code、Cursor、CodexなどのAIコーディングエージェント向けに、ディスク上のSQLiteファイルをMCP経由で提供するローカル優先の永続メモリ。
- スター
- 283
- フォーク
- 32
- 未解決の Issue
- 10
- 最終コミット
- 先月
これは何?
AIコーディングエージェントはセッションをまたぐと決定事項や学び、プロジェクトのコンテキストを忘れてしまうため、開発者は同じ制約を何度も説明することになります。PMBはそれらをローカルのワークスペースに永続メモリとして保存します。SQLiteを信頼できる唯一の情報源とし、その隣に再構築可能なLanceDBのベクトルインデックスを配置します。エージェントはprepare(message)やrecall(query)などのMCPツールを通じてメモリを読み取ります。これらのツールはBM25、ベクトル検索、エンティティグラフ、任意の再ランキングを組み合わせます。
Claude CodeとCodexでは、PMBのライフサイクルフックをインストールして、モデルの応答前に関連メモリを注入し、その後にエージェントの操作を記録できます。また、プロジェクトのコード、PDF、Markdown、チャットのエクスポートデータをインデックス化でき、エンティティや学び、パフォーマンスを閲覧できるローカルWebダッシュボード(127.0.0.1)も備えています。標準の埋め込みモデルは50以上の言語に対応しているため、ある言語でのクエリから別の言語で保存された情報を見つけられます。
このツールはデフォルトでオフライン動作し、APIキーは不要です。CLIではスナップショットの作成、検証、MarkdownまたはJSONへのエクスポートができます。Python製で、pipでインストールでき、ライセンスはApache 2.0です。
主な機能
- 01決定事項、学び、事実、プロジェクト構造をローカルのSQLiteファイルに保存。
- 02MCP経由でClaude Code、Cursor、Codex、Windsurf、Zed、VS Codeに接続。
- 03BM25、ベクトル検索、エンティティグラフ、任意の再ランキングを組み合わせたハイブリッド検索。
- 04対応エージェントでは、ライフサイクルフックによりモデルの応答前に関連メモリを注入。
- 05プロジェクトのコード、PDF、Markdown、ChatGPTのエクスポートデータをインデックス化。
- 06メモリを閲覧できるローカルダッシュボードと、検証済みスナップショットおよび復元機能。
ユースケース
- コーディングセッションをまたいで、アーキテクチャ上の決定事項やプロジェクトの制約を参照できるようにする。
- クラウドサービスにデータを送信せず、Claude CodeやCursorにコードベースの永続的なコンテキストを提供する。
- 個人のメモ、PDF、過去のエージェントとの会話をターミナルから検索する。
クイックスタート
- 1
PyPIからパッケージをインストールします
pip install pmb-ai - 2
検出されたAIエージェントにPMBを組み込みます
pmb setup - 3
最初の検索を高速化するため、埋め込みモデルを事前に読み込みます
pmb warmup - 4
エージェントを再起動し、doctorチェックですべてが正しく組み込まれていることを確認します
pmb doctor
使う前に知っておきたいこと
- デフォルトの埋め込みモデルは約450 MBで、初回使用前にダウンロードする必要があります。
- フックやオプションのクロスエンコーダーによる再ランキングなど、一部の機能は特定のエージェントや構成でのみ利用できます。
収録されている特集
トピック
よくある質問
- pmb とは?
- Claude Code、Cursor、CodexなどのAIコーディングエージェント向けに、ディスク上のSQLiteファイルをMCP経由で提供するローカル優先の永続メモリ。 AIコーディングエージェントはセッションをまたぐと決定事項や学び、プロジェクトのコンテキストを忘れてしまうため、開発者は同じ制約を何度も説明することになります。PMBはそれらをローカルのワークスペースに永続メモリとして保存します。SQLiteを信頼できる唯一の情報源とし、その隣に再構築可能なLanceDBのベクトルインデックスを配置します。エージェントはprepare(message)やrecall(query)などのMCPツールを通じてメモリを読み取ります。これらのツールはBM25、ベクトル検索、エンティティグラフ、任意の再ランキングを組み合わせます。
- pmb は無料で使えますか?ライセンスは?
- pmb は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- pmb は今もメンテナンスされていますか?
- 半年以内に更新あり。pmb の最終コミットは 2026年9月23日 です。
- pmb は何に使えますか?
- コーディングセッションをまたいで、アーキテクチャ上の決定事項やプロジェクトの制約を参照できるようにする。 クラウドサービスにデータを送信せず、Claude CodeやCursorにコードベースの永続的なコンテキストを提供する。 個人のメモ、PDF、過去のエージェントとの会話をターミナルから検索する。
- pmb のインストール方法は?
- PyPIからパッケージをインストールします: pip install pmb-ai 検出されたAIエージェントにPMBを組み込みます: pmb setup 最初の検索を高速化するため、埋め込みモデルを事前に読み込みます: pmb warmup エージェントを再起動し、doctorチェックですべてが正しく組み込まれていることを確認します: pmb doctor
- pmb はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/oleksiijko/pmb
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
コーディングエージェント向けの永続メモリ。セッション中の活動を記録してAIで圧縮し、後続セッションに関連するコンテキストを引き継ぎます。
過去の会話をセマンティック検索できる、MCPサーバーとして動作するClaude Code向けローカルRustツールです。
Markdownのメモ、会議の文字起こし、ドキュメントを対象に、BM25、ベクトル検索、LLMによる再ランキングを組み合わせたローカル実行型のCLI検索エンジン。
会話を分析してユーザー、エージェント、グループを時間とともにモデル化する、ステートフルなAIエージェント向けメモリ基盤。
誰の記憶か、情報源、いつ有効だったか、誰が読めるかを記録する、AI向けローカルメモリストア。