agent-memory

コーディングエージェント向けのローカルマークダウンメモリ。 プロバイダーもツールも問いません。

共有レイアウトがなければ、各ベンダーは墓場を持っているのと同じです。つまり、セッションアーカイブは、新しいエージェントに教え直さない限り、永続的なアイデンティティにはまったくなりません。詳しい理由については、abi/WHY.md を参照してください(vs RAG、vs vault、vs ベンダーメモリ)。参照実装のロードマップ: ROADMAP.md。

あなたのメモリは、あなたが所有するフォルダにあります。~/.agents/memory(アイデンティティとプロジェクトマップ)と <repo>/.agents/memory(プロジェクトごとの作業)。あなたの Agent — またはマークけどoptional MCPを読むホストであればどれでも — 同じレイアウトを使います。

Markdown は source of truth です。このリポジトリの Python MCP は 参照実装 であり、プロプライエタリなバックエンドではありません。

ABI(安定したコントラクト)

abi/ 配下に提供。バージョン管理され、文書化され、実装 非依存です。

インストール時、abi/LAYOUT.md は ~/.agents/memory/LAYOUT.md にコピーされます。注入と CLI フラグ: abi/INSTALL.md。機械可読な出力: python -m agent_memory --help-json。

Related MCP server: mcp-chest-memory

参照実装 (このリポジトリ)

Python は src/agent_memory/ にあります(クローンから pip install -e .)。

テンプレートは git 内にのみ存在: examples/*.example.*。実際のストアは ~/.agents/memory。Markdown がこのクローンに漏れた場合は python -m agent_memory consolidate を実行してください。

コーディングエージェントの場合: [インストールは AGENTS.md に従ってください。]

レイアウト (概要)

検索は、ユーザーのツリーと登録済みの全プロジェクトツリーの和集合を対象にします。チャットのファイル本体はプロダクトフォルダに残ります。chats-index.md にはタイトルとパスのみが含まれます。

セットアップ

pip と MCP は同じインタプリタを使用します。

python -m pip install -e .
python -m agent_memory sync --init
python -m agent_memory inventory

初回実行時に examples/*.example.* を使って ~/.agents/memory/USER.md と scan.json を埋めてください。MCP をマージした後は、Agent をリロードしてください。

Windows のシンボリックリンクのスタブとハードリンクのフォールバックについては abi/PLATFORM.md を参照してください。

スクリプト

python -m agent_memory inventory
python -m agent_memory inventory --json
python -m agent_memory inventory --register SLUG "/path/to/repo" "role" "stack"
python -m agent_memory sync
python -m agent_memory --help-json
python -m agent_memory sync --help-json
python -m agent_memory inventory --help-json
python -m agent_memory ingest catalog

インストール後、PATH 上の agent-memory は python -m agent_memory と同じです。