OKF Agent Memory公開、Git管理でAIの記憶保持

AIコーディングエージェントを使っていて、会話が終わるたびにプロジェクトの背景説明をやり直す面倒さを感じたことはないでしょうか。オープンソースプロジェクト「OKF Agent Memory」は、この課題に取り組む新しいメモリ基盤です。AIエージェントが蓄積した知識を、Gitで管理できるMarkdownファイルとして保存する仕組みを採用しており、外部のベクトルデータベース(文章を数値の並びに変換して類似度検索する仕組み)や専用APIを一切使わない設計が特徴です。Hacker Newsでも公開直後から74ポイント・22コメントを集め、開発者コミュニティの関心を集めています。

背景と文脈
技術/ビジネス面
これからどうなるか
まとめ
参考リンク

背景と文脈

Claude CodeやCursorのようなAIコーディングエージェントは、会話セッションが終わると原則としてそれまでの文脈を失います。プロジェクト固有の設計方針や過去の決定事項を毎回説明し直す手間は、こうしたツールを日常的に使う開発者にとって共通の悩みでした。

この課題への対策として、これまでは会話ログをベクトルデータベースに保存し、意味的な類似度で関連情報を検索する「記憶」機能を提供する製品が主流でした。ただしこの方式は外部サービスへのAPI呼び出しが発生するため、利用のたびにコストがかかるうえ、特定のベンダーの仕組みに依存してしまう問題がありました。

OKF Agent Memoryは、こうしたベンダー依存を避けるため「Open Knowledge Format(OKF)」という仕様のバージョン0.2をベースに設計されています。特定のツールやサービスに縛られない、汎用的な知識の保存形式を目指すプロジェクトで、保存されたデータはテキストファイルとしてそのままGitリポジトリに含められます。

技術/ビジネス面

black laptop computer turned-on displaying source code on table — Photo by Jantine Doornbos on Unsplash

okf-memory/okf-agent-memoryは、プロジェクトの知識をリポジトリ内の「knowledge」ディレクトリに、YAML形式のメタ情報を付けたMarkdownファイルとして保存します。すべてGitで版管理されるため、通常のコード変更と同じようにレビューや差分確認ができる点が大きな特徴です。

検索にはBM25という、単語の出現頻度に基づく昔ながらのキーワード検索アルゴリズムを採用しています。文章を数値ベクトルに変換して類似度を計算する一般的な埋め込み検索とは異なり、外部APIを呼ばずメモリ上だけで完結するため、検索速度は300マイクロ秒未満と非常に高速です。

また「progressive disclosure」と呼ばれる仕組みで、関連する知識を階層的にリンクさせ、エージェントが必要な情報だけを段階的に読み込めるようにしています。これにより、AIが一度に処理できる文章量の上限であるコンテキストウィンドウを無駄に消費せず、開発元は従来手法比で約80%のトークン削減を主張しています。エージェントが新しい知識を書き込む前に既存の内容を検索する「search-before-write」の原則も組み込まれており、重複や矛盾した情報が蓄積しにくい設計です。

実装は外部依存ゼロの純粋なGo言語で、単一のバイナリとして配布され起動は5ミリ秒未満、メモリ使用量も15MB未満に抑えられています。Claude CodeやCursorなど各種ツールと接続するためのMCP(Model Context Protocol、AIエージェントが外部ツールやデータソースに接続するための共通規格)サーバーも標準で内蔵し、ライセンスはMITです。

これからどうなるか

AIエージェントの記憶が特定ベンダーに縛られず、コードと同じくGitでバージョン管理できる点は、チーム開発において実務的な意味を持ちます。プロジェクトの設計判断や命名規則の背景をMarkdownとして残しておけば、Claude CodeからCursorに乗り換えるような場面でも知識を持ち越せます。

開発者にとっては、ホスティング型のベクトルDBを契約せずに済み、埋め込み生成のAPI課金も発生しない点が実用面での魅力です。単一バイナリで軽量なため、CIパイプラインや使い捨てのコンテナ環境にも組み込みやすく、既存のMCP対応エージェントに追加コストなしで記憶機能を持たせられます。一方でBM25はキーワード一致に依存するため、命名や表記の揺れが大きいプロジェクトでは意味的に近い情報を取りこぼす可能性があり、今後の改善余地として注目されます。