agent-magnet について
agent-magnetは、Claude、Cursor、Codexを使う人向けの、ローカル動作が既定のメモリレイヤーです。プロジェクトの背景や好みをセッション間で自動整理し、記憶の削除・完了処理やチーム共有にも対応します。
主な機能
- 01作業コンテキストの自動記録
- 02Claude、Cursor、Codex間でのメモリ共有
- 03決定事項・好み・目標の整理
- 04メモリの削除や完了扱い
- 05チームメモリの共有
活用シーン
- 01AIセッション間でプロジェクトの背景を引き継ぐ
- 02対応ツール間で好みや規約を再利用する
- 03チームの決定事項をメンバーのコンテキストとして共有する
MCP 対応
Codexやその他のMCPクライアント向けにMCPサーバーを提供します。`agent-magnet init`はClaude Code、Claude Desktop、Cursorを検出して設定します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx agent-magnetMAGNET_USER_IDYour identifier used as the memory key across all toolsMAGNET_OPENAI_KEYシークレットOpenAI API key for the reflector and classifier modelsMAGNET_LOCAL_MODESet to 1 to use local SQLite storage — no Redis or external services neededMAGNET_REDIS_URLRedis connection URL for persistent shared storage (overrides local mode)MAGNET_PROJECT_IDNamespace for memory isolation across projects (defaults to 'default')ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
AI はセッションが新しくなるたびに、プロジェクトのことを忘れてしまいます。これで解決します。
できること
- 作業中に自動で学習します。「これを覚えて」と頼む必要はありません
- Claude、Cursor、Codex 間で同じメモリを共有します
- 忘れたり、完了済みとしてマークしたりできます。メモリがただ積み上がることはありません
クイックスタート
pip install agent-magnet
agent-magnet init
インストールはこれだけです。Redis もキーも不要で、デフォルトでローカルに保存されます。
記憶する内容
決定事項、規約、注意点、失敗した試み、目標、好み、実行したアクションを、自動で整理してひとつのメモリにまとめます。
チームメモリ
チームで共有できるメモリです。メンバーひとりの決定が、チーム全員のコンテキストになります。利用には agentmagnet.app から有料の Agent Magnet キーを取得する必要があります。
どこでも使えます
Claude、Cursor、Codex で同じメモリを使えます。デフォルトではローカルに保存されます。agent-magnet init を実行すると、Claude Code、Claude Desktop、Cursor を自動で検出して設定します。
手動での MCP 設定(Codex、またはその他の MCP クライアント)
{
"mcpServers": {
"agent-magnet": {
"command": "agent-magnet-mcp",
"env": { "MAGNET_USER_ID": "your_name" }
}
}
}
MIT ライセンスです。コントリビュートしてください。この README がコンテキストウィンドウの節約に役立ったら、⭐もお願いします。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。