agents-memory

AIコーディングアシスタント向けのローカルMarkdownメモリ＆クロスエージェントコンテキストエンジン。
Claude Code、Cursor、Antigravity、Zed 間で共有される、単一の永続的なアイデンティティ。

なぜ .agents/memory なのか？

agents-memory という名前は、その普遍的なストレージ標準である .agents/memory に直接由来しています。

• グローバル: ~/.agents/memory/ は、永続的なアイデンティティ、スタックのデフォルト設定、永続的なコンセプト、プロジェクトインデックスを保存します。

• リポジトリ: <repo>/.agents/memory/ は、リポジトリ固有の事実、アーキテクチャADR、ステージングインボックスを保存します。

AIベンダーが独自のストアに設定を分散させる一方で、.agents/ は、すべてのエージェント設定と共有インテリジェンスのための、単一のオープンでベンダーニュートラルなファイルシステムハブを提供します。

agents-memory はこれを 純粋なMarkdownファーストのアーキテクチャ で実現します:

• ローカル＆オフライン: あなたのアイデンティティとリポジトリメモリは、プレーンファイル（~/.agents/memory/ と <repo>/.agents/memory/）に保存されます。

• 人間が読めてGitフレンドリー: 任意のテキストエディタで編集し、gitで差分を確認し、必要なときにコミットできます。

• ユニバーサルMCPサーバー: メモリツール（search_memory、add_memory、get_project_memories、distill_batch）をすべての最新エージェントに公開します。

• 自律的な取り込みと蒸留: セッションログ（OpenAI、Claude、Cursor、Copilot、Antigravity、Pi）から永続的なルールとアーキテクチャ上の決定を抽出します。

Related MCP server: agent-julia

アーキテクチャとフロー

 ┌─────────────────────────────────────────────────────────────┐
 │                       SESSION INGEST                        │
 │  OpenAI Exports · Claude JSONL · Cursor · Antigravity · Pi  │
 └──────────────────────────────┬──────────────────────────────┘
                                │  ingest catalog / extract
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                       STAGING INBOX                         │
 │        Raw captured bullets & noise-filtered facts          │
 └──────────────────────────────┬──────────────────────────────┘
                                │  distill_batch / skill
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                     LOCAL MEMORY STORE                      │
 │   ~/.agents/memory/USER.md     ~/.agents/memory/PROJECTS.md │
 │   ~/.agents/memory/concepts/   <repo>/.agents/memory/       │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │       IDE INJECTION         │ │     MCP SERVER & CLERK      │
 │  Cursor Rules · Zed Context │ │  search_memory · add_memory │
 │  Antigravity AGENTS.md      │ │  Universal Tool Integration │
 └─────────────────────────────┘ └─────────────────────────────┘

クイックスタート

1ステップセットアップ

pip install agents-memory && agents-memory sync --init

~/.agents/memory/ をスキャフォールドし、インストール済みのIDEにMCP設定を自動配線し、アシスタントスキルを登録します。

[!TIP] 🤖 エージェント駆動セットアップ（ゼロフリクション）:
コーディングエージェントにこう伝えるだけです: 「agents-memoryをインストールしてセットアップして」
エージェントがパッケージをインストールし、スタックの好みを一度だけ尋ね、USER.md プロフィールを記入し、リポジトリを自律的に登録します。

CLIリファレンス

サポートされているエコシステム

• Claude Code: シンボリックリンク / 正規の AGENTS.md とMCPサーバーを介してバインドされます。

• Google Antigravity: .gemini/config ルールと agents-memory MCPを介して統合されます。

• Cursor: ルールを自動的に注入し、.cursor/mcp.json を設定します。

• Zed: context_servers を設定し、アシスタントスキルをミラーリングします。

• VS Code / Copilot: ローカル状態データベースからセッション履歴を取り込みます。

互換性あり: Windsurf、Cline、Roo-Code、Aider、Continue.dev、OpenAI ChatGPT、Pi、Goose、およびMCP準拠の任意のAIアシスタント。

オープンABI仕様

正式な実装非依存のレイアウト仕様は abi/ にあります:

• abi/WHY.md — アーキテクチャ上の決定と、MarkdownがRAGに勝る理由。

• abi/LAYOUT.md — ディレクトリ分類とパス契約。

• abi/KINDS.md — 型付きメモリ分類（concepts、facts、decisions）。

• abi/MCP.md — ツール定義とリクエスト/レスポンス仕様。

• abi/INGEST.md — カタログ、抽出、蒸留パイプライン。

• abi/INJECTION.md — ホストルール注入メカニズム。

テストと検証

包括的なテストスイートと蒸留ベンチマークを実行します:

python tests/run_all_tests.py

ライセンス

MITライセンス。詳細は LICENSE を参照してください。