Repolode
tigerless-labs

tigerless-labs/agent-memory

AIエージェント向けの長期記憶ランタイム。記憶をプレーンなMarkdownで保存し、ローカルで関連度順に検索できます。Claude Code、Codex CLIなどシェルを使えるエージェント間でストアを共有します。

スター
4,310
フォーク
204
未解決の Issue
9
最終コミット
15 時間前

これは何?

agent-memoryは、セッション終了後も保持される記憶をAIエージェントに提供します。記憶は1つのディレクトリ内にMarkdownファイルとして保存され、その隣にあるSQLiteインデックスは再構築可能なキャッシュです。そのため、インデックスを削除しても知識は失われません。Claude Code、Codex CLI、Muse Codeのほか、シェルコマンドを実行できるツールなら、どれでも同じストアを読み書きできます。

検索はローカルで行われ、関連度順に結果が返されます。ファイルパス付きの1行要約のリストを返し、エージェントはタスクに必要な深さに応じて、概要からファイル全体、引用元となったセッションの生メッセージまで、各結果を開いて確認できます。書き込みはセッション終了やコンパクションなど、会話の区切りで実行されます。また、別途実行されるスリープ時の処理で記憶を統合し、削除候補を提示してユーザーの確認を求めます。古くなった記憶も保持され、指定した日時時点での検索にも対応します。

ライブラリ自体にLLMクライアントは含まれておらず、判断はホストエージェントが使うCLIに委ねられます。オプションとして、FastEmbedによるベクトル検索とjiebaによるCJKトークナイズを利用できます。

主な機能

  • 01Markdownファイルを信頼できる情報源とし、SQLiteインデックスは削除して再構築できます。
  • 02ローカルのBM25検索に対応し、reciprocal-rank fusionによるベクトル検索との統合もオプションで利用できます。
  • 03概要、アウトライン、ファイル全体、引用元の生メッセージへと段階的に読み進められます。
  • 04セッションの区切りで自動的に書き込み、スリープ時の統合処理では削除に確認が必要です。
  • 05Claude Code、Codex CLI、Muse Code間でストアを共有でき、MCPサーバーとしても利用できます。
  • 06古くなった記憶を履歴として保持し、特定の時点における記憶を検索できます。

ユースケース

  • 別々のセッション間で、コーディングエージェントにプロジェクトの決定事項を引き継がせる。
  • 同じマシン上にある複数のエージェントホストで、1つのメモリストアを共有する。
  • grepで検索でき、Gitでバージョン管理できる、ツールに依存しないポータブルなファイルでエージェントの記憶を管理する。
  • オプションのCJKトークナイザーを使って、エージェントメモリに中国語の検索機能を追加する。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/tigerless-labs/agent-memory.git
  2. 2

    uvを使ってチェックアウトから依存関係をインストールする

    uv sync --all-packages
  3. 3

    メモリストアを初期化する

    mem init
  4. 4

    Claude Codeに接続する

    mem setup --host claude-code

使う前に知っておきたいこと

  • まだPyPIリリースがないため、インストールにはソースのチェックアウトが必要です。
  • Python 3.12以降とuvが必要です。
  • バージョン0.1.0は初期段階のため、Codex CLIのセットアップでは追加のサンドボックス承認や信頼の承認が必要になる場合があります。

収録されている特集

トピック

よくある質問

agent-memory とは?
AIエージェント向けの長期記憶ランタイム。記憶をプレーンなMarkdownで保存し、ローカルで関連度順に検索できます。Claude Code、Codex CLIなどシェルを使えるエージェント間でストアを共有します。 agent-memoryは、セッション終了後も保持される記憶をAIエージェントに提供します。記憶は1つのディレクトリ内にMarkdownファイルとして保存され、その隣にあるSQLiteインデックスは再構築可能なキャッシュです。そのため、インデックスを削除しても知識は失われません。Claude Code、Codex CLI、Muse Codeのほか、シェルコマンドを実行できるツールなら、どれでも同じストアを読み書きできます。
agent-memory は無料で使えますか?ライセンスは?
agent-memory は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
agent-memory は今もメンテナンスされていますか?
活発にメンテナンス中。agent-memory の最終コミットは 2026年11月6日 です。
agent-memory は何に使えますか?
別々のセッション間で、コーディングエージェントにプロジェクトの決定事項を引き継がせる。 同じマシン上にある複数のエージェントホストで、1つのメモリストアを共有する。 grepで検索でき、Gitでバージョン管理できる、ツールに依存しないポータブルなファイルでエージェントの記憶を管理する。 オプションのCJKトークナイザーを使って、エージェントメモリに中国語の検索機能を追加する。
agent-memory のインストール方法は?
リポジトリをクローンする: git clone https://github.com/tigerless-labs/agent-memory.git uvを使ってチェックアウトから依存関係をインストールする: uv sync --all-packages メモリストアを初期化する: mem init Claude Codeに接続する: mem setup --host claude-code
agent-memory はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/tigerless-labs/agent-memory

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト