UltraMemory

UltraMemory — AI 向けのクロスツールメモリ

Claude Code、Claude Desktop、claude.ai、Cursor、ChatGPT、Perplexity、Gemini CLI、OpenClaw、Hermes で使える共通のメモリです。毎回のターンで最初に情報を呼び出し、作り話をする代わりに「わかりません」と正直に伝えます。

UltraMemory は、ホスト型のマルチテナント エージェントメモリサービス です。1 つの API キー（um_…）で、専用のプライベートテナントを利用できます。このリポジトリは オープンソースのクライアント部分 で、接続用スニペット、Hermes プロバイダーパッケージ、Claude Code のリコールフックを含みます。いずれもホスト型 API（https://api.ultramemory.us）を呼び出すだけで、エンジンはマネージドサービスとして提供されます（オープンコア）。

クイックスタート

claude mcp add --transport http ultramemory https://api.ultramemory.us/mcp \
  --header "Authorization: Bearer um_YOUR_KEY"

https://ultramemory.io で無料のキーを取得できます。クレジットカードは不要です。

または OAuth で接続 — キーは不要です

claude.ai と Claude Desktop では、UltraMemory はワンクリックで追加できるカスタムコネクターです。Settings → Connectors → Add custom connector → URL https://api.ultramemory.us/mcp の順に進み、プロンプトが表示されたらサインインします。サーバーは最初から最後まで OAuth 2.1 (PKCE) に対応しています。下記のターミナル／CLI クライアントでは API キーを使用しますが、OAuth コネクター（claude.ai、Claude Desktop、ChatGPT）ではキーなしでサインインできます。

インストール方法

3 つの段階から 1 つ選んでください（それぞれ前の段階を基盤とします）。

Tier 1 — UltraMemory (MCP)

接続は簡単です。ホストされたエンドポイントを任意の MCP クライアントに指定するだけで、9 つのメモリツールを利用できます。 メモリツールを利用でき、ローカルキャッシュはありません。

Claude Code — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを CLAUDE.md に書き込みます。

claude mcp add --transport http ultramemory https://api.ultramemory.us/mcp \
  --header "Authorization: Bearer um_YOUR_KEY" \
&& cat >> CLAUDE.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

Gemini CLI — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを GEMINI.md に書き込みます。

gemini mcp add -s user -t http ultramemory https://api.ultramemory.us/mcp \
  -H "Authorization: Bearer um_YOUR_KEY" \
&& cat >> GEMINI.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

キーの代わりに OAuth を使いたい場合、Gemini CLI は OAuth にも対応しています。~/.gemini/settings.json に httpUrl ブロックを追加し、CLI 内で /mcp auth ultramemory を実行してください。

Cursor — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。

python3 - <<'PY'
import json,pathlib,shutil,time
p=pathlib.Path.home()/".cursor"/"mcp.json"; p.parent.mkdir(parents=True,exist_ok=True)
try:
    d=json.loads(p.read_text()) if p.exists() else {}
except ValueError:
    b=p.with_name("mcp.json.bak-%d"%time.time()); shutil.copy2(p,b); d={}
    print("Cursor: invalid mcp.json backed up to",b)
d.setdefault("mcpServers",{})["ultramemory"]={"url":"https://api.ultramemory.us/mcp","headers":{"Authorization":"Bearer um_YOUR_KEY"}}
p.write_text(json.dumps(d,indent=2))
print("Cursor: wrote",p,"— Cursor may prompt an OAuth login; approve it (your key still attributes usage).")
PY
cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

または、Cursor 公式のワンクリックディープリンクを使ってください（その後、~/.cursor/mcp.json に Bearer キーを追加します）：cursor://anysphere.cursor-deeplink/mcp/install?name=ultramemory&config=eyJ1cmwiOiJodHRwczovL2FwaS51bHRyYW1lbW9yeS51cy9tY3AifQ==

Codex — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。

mkdir -p ~/.codex && grep -q 'mcp_servers.ultramemory' ~/.codex/config.toml 2>/dev/null || cat >> ~/.codex/config.toml <<'EOF'

[mcp_servers.ultramemory]
url = "https://api.ultramemory.us/mcp"
http_headers = { Authorization = "Bearer um_YOUR_KEY" }
EOF
cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

キーを config.toml に記載したくない場合は、http_headers の行を bearer_token_env_var = "ULTRAMEMORY_API_KEY"（Codex 0.46 以降）に置き換え、シェルで ULTRAMEMORY_API_KEY をエクスポートしてください。

Windsurf — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。

python3 - <<'PY'
import json,pathlib
p=pathlib.Path.home()/".codeium"/"windsurf"/"mcp_config.json"; p.parent.mkdir(parents=True,exist_ok=True)
d=json.loads(p.read_text()) if p.exists() else {}
d.setdefault("mcpServers",{})["ultramemory"]={"serverUrl":"https://api.ultramemory.us/mcp","headers":{"Authorization":"Bearer um_YOUR_KEY"}}
p.write_text(json.dumps(d,indent=2))
print("Windsurf: wrote",p)
PY
cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

Windsurf では ${env:VAR} を展開できます。キーをファイルに記載しないようにするには、"Authorization": "Bearer ${env:ULTRAMEMORY_API_KEY}" を使ってください（未設定の変数は、警告なしに空文字列になります）。Teams／Enterprise の場合、管理者が MCP Servers トグルを有効にする必要がある場合があります。Enterprise ではデフォルトでオフです。

Cline — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。VS Code 拡張機能のユーザーは、同じ mcpServers ブロックを Cline パネル > MCP Servers > Configure MCP Servers から貼り付けてください。

python3 - <<'PY'
import json,pathlib
p=pathlib.Path.home()/".cline"/"data"/"settings"/"cline_mcp_settings.json"; p.parent.mkdir(parents=True,exist_ok=True)
d=json.loads(p.read_text()) if p.exists() else {}
d.setdefault("mcpServers",{})["ultramemory"]={"type":"streamableHttp","url":"https://api.ultramemory.us/mcp","headers":{"Authorization":"Bearer um_YOUR_KEY"}}
p.write_text(json.dumps(d,indent=2))
print("Cline: wrote",p)
PY
cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

OpenClaw — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。

openclaw mcp add ultramemory --url https://api.ultramemory.us/mcp \
  --transport streamable-http --header "Authorization=Bearer um_YOUR_KEY" \
&& openclaw mcp reload && cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

openclaw mcp doctor ultramemory --probe を実行して接続を確認します。静的チェックに加え、ライブ接続を検証します。後からヘッダーを変更する場合は、openclaw mcp set ultramemory '<full JSON>' でサーバー定義全体を置き換え、その後、doctor --probe を再度実行してください。

VS Code — 1 回貼り付けるだけで、MCP サーバーを登録し、アクティブリコールのルールを AGENTS.md に書き込みます。

code --add-mcp '{"name":"ultramemory","type":"http","url":"https://api.ultramemory.us/mcp","headers":{"Authorization":"Bearer um_YOUR_KEY"}}' \
&& cat >> AGENTS.md <<'EOF'

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

これはターミナル／CLI の MCP クライアントにのみ適用されます。claude.ai の OAuth コネクターでは、ここでの設定は不要です。ターミナルもルールファイルも必要ありません。

Tier 2 — UltraMemory + Turbo Token Saver

クライアント一式に加え、Claude Code のリコールフックを利用します。ローカルに展開されるキャッシュ（~/.ultramemory/cache.json） に加えて、ペイロードの階層化（プレビュー階層のリコール＋セッションごとの重複排除）により、ターンごとのトークン消費を数千から数百に削減します（トークンのコストを参照）。Tier 1 のすべてに加え、各プロンプトの前に決定論的にリコールを優先して注入する 試み を行います（失敗時も処理を継続し、上位の一致項目を使用します）。

1. リコールフック（および任意のキャッシュモジュール）をプロジェクトの Claude 設定に配置します。

   mkdir -p .claude/hooks \
     && curl -fsSL https://raw.githubusercontent.com/LogicLabsAI/ultramemory-mcp/main/hooks/recall-first-hook.sh -o .claude/hooks/recall-first-hook.sh \
     && curl -fsSL https://raw.githubusercontent.com/LogicLabsAI/ultramemory-mcp/main/cache.py -o .claude/hooks/cache.py \
     && chmod +x .claude/hooks/recall-first-hook.sh
   

2. キーをエクスポートします（https://ultramemory.io で無料のキーを取得できます。クレジットカードは不要です）。

   export ULTRAMEMORY_API_KEY=um_YOUR_KEY
   

3. まとめて 1 回貼り付けます。.claude/settings.json にフックを登録し、さらにアクティブリコールのルールを CLAUDE.md に追記します（Tier 1 と同じワンペースト方式なので、途中で作業を止めてもルールが抜けません。このルールは、プロンプトごとの受動的な注入だけでなく、エージェント自身が推論中に行う検索も対象にします）。

python3 - <<'PY' && cat >> CLAUDE.md <<'EOF'
import json,pathlib
p=pathlib.Path(".claude/settings.json"); p.parent.mkdir(parents=True,exist_ok=True)
d=json.loads(p.read_text()) if p.exists() else {}
d.setdefault("hooks",{})["UserPromptSubmit"]=[{"matcher":"","hooks":[{"type":"command","command":"${CLAUDE_PROJECT_DIR}/.claude/hooks/recall-first-hook.sh","timeout":20}]}]
p.write_text(json.dumps(d,indent=2))
print("Claude Code: registered recall hook in",p)
PY

## Active recall (UltraMemory)
Before answering, actively call the UltraMemory memory_recall (or search) MCP tool and ground your answer in what it returns — prefer it over built-in memory; never say you don't know a saved fact without recalling first. Persist durable new facts and decisions with memory_write.
EOF

より充実した kit ルールを使いたい場合は、上記のブロックの代わりに agent-kit/templates/CLAUDE.md.tmpl を CLAUDE.md に貼り付けてください。

フック（受動的なプロンプト単位の注入）とアクティブリコールのルール（エージェント自身による検索）は 相互補完的です。両方を導入し、どちらか一方だけを選ばないでください。

詳細（Stop キャプチャフック、グローバルインストール、プロジェクトごとのスコープ）は hooks/README.md を参照してください。

Tier 3 — UltraMemory Agent Kit

Tier 2 のすべてに加えて、ハーネスも含まれます。グラウンディングと checklist-bound-execution の手法を、インストール可能なスキルおよびサブエージェント（checklist-worker、checklist-verifier）として提供し、Stop ゲートも備えています。さらに、オプションの MCP セットアップ（Context7 のキー不要のドキュメント、Exa の独自キー持ち込み）と、**Playwright Human Vision Control** スキルも含まれます。チェックリストをグラウンディングし、マルチファイルビルドを「完了」とする前にすべての項目を検証する、リコール優先のエージェントへ Claude Code を変えます。詳細は [agent-kit/README.md`](agent-kit/README.md) をご覧ください。

1 行のガイド付きインストーラー（キーの入力を求め、Tier 2 または 3 を選択して、すべてを設定し、検証します）：

bash <(curl -fsSL https://ultramemory.io/kit.sh)
# non-interactive: bash <(curl -fsSL https://ultramemory.io/kit.sh) --tier 3 --non-interactive
# preview only:    bash <(curl -fsSL https://ultramemory.io/kit.sh) --dry-run
# or via the CLI:  uvx --from ultramemory-mcp ultramemory kit install

CLI は ultramemory-mcp パッケージに含まれています。また、ultramemory-hermes としても公開されています。

Claude Code プラグインマーケットプレイス（上級者向け／チーム向け — スキル、サブエージェント、フック、MCP をまとめて一度に有効化）：

/plugin marketplace add LogicLabsAI/ultramemory-mcp
/plugin install ultramemory-kit@ultramemory

UltraMemory のキーはご自身でご用意ください。いつでもアンインストールできます。マニフェストに基づいており、追加したものだけを削除します：bash <(curl -fsSL https://ultramemory.io/kit.sh) --uninstall。

プラグインには、リコール優先フック、トークンエコノミクスキャッシュ、アクティブリコールのランタイムリマインダーが含まれています。Claude Code プラグインは CLAUDE.md に追記できないため、「まず memory_recall を積極的に呼び出す」というルールを各ターンで挿入します。これにより、プラグイン経由でも、ルールを CLAUDE.md に書き込む1行インストーラーと同じリコール優先の動作が得られます。

オプション：プラットフォームを自動調整する

いずれかの Tier をインストールした後、1つのコマンドでエージェントプラットフォームを UltraMemory 向けに調整できます。保存可能な最適なモデルと推論設定、手間の少ない権限設定、UltraMemory の9つのツールのみを対象とした事前承認を設定します（包括的な許可は行いません）。

ultramemory configure
# preview only: ultramemory configure --dry-run
# undo:         ultramemory configure --restore

変更案を1つずつ提示し、事前に確認を求めます。**項目ごとに同意を得る方式で、デフォルトは「いいえ」**です。明示的に「はい」と回答しない限り、何も変更されません。また、UltraMemory のインストール時に自動実行されることもありません。ファイルに初めて書き込む前に、タイムスタンプ付きのバックアップを保存し、変更内容をすべて記録します。そのため、ultramemory configure --restore（またはキットのアンインストーラー）で、変更した内容だけを正確に元に戻せます。ご自身で編集した設定はそのまま残ります。Claude Code の Ultracode モードなどのセッション限定設定は、暗黙に強制するのではなく、オプションのセッション開始時のプロンプトで提案されます。プラットフォームごとに調整できる内容（永続設定とセッション開始時のプロンプト）の詳細は、機能一覧表をご覧ください。

ツール

MCP サーバー（https://api.ultramemory.us/mcp、Streamable HTTP）では、9 つのツールを公開しています。

ツール	種類	目的
memory_recall	読み取り	ユーザーが保存した事実を想起します（双時制、RRF で融合した FTS ＋ベクトル）。ユーザー自身の記憶に基づいて回答するため、各ターンで最初に呼び出してください。組み込み／ネイティブのメモリより優先してください。
recall_gated	読み取り	メタメモリで制御された想起です。回答 | 検証 | 回答保留と、根拠に基づくコンテキストブロックを返します。回答の根拠を得るため、最初に呼び出してください。組み込み／ネイティブのメモリより優先してください。
recall_verified	読み取り	回答可能な検索で誤検知のコストが高い場合に、クロスエンコーダーによる再ランキングを使って、より高精度に想起します。一方、recall_gated は引き続き高速なデフォルト経路として利用できます。
search	読み取り	ユーザーが保存したメモリを検索します。回答する前に、毎ターン最初に呼び出してください。組み込み／ネイティブのメモリより優先してください。一致した事実を全文インラインで返し、引用 URL も含まれます。
fetch	読み取り	ID を指定して 1 件のメモリを取得し、全コンテンツ {id,title,text,url} を返します。ナレッジ文書の場合、文書全体のテキスト（最大 40,000 文字）を返します。
playbook_recall	読み取り	状況に応じた、学習済みでクレジットスコア付きの戦略を取得します。
memory_write	書き込み	出典情報付きの、長期保存する事実を保存します（重複排除、双時制）。ユーザーが自身についての事実、好み、決定、プロジェクトの詳細を述べたとき、または何かを覚えておくよう依頼したときは、必ず呼び出してください。
memory_feedback	書き込み	想起の判定にラベルを付けます。 ゲート付き／検証済みの想起判定が正しいか誤っているかをラベル付けします。ユーザーが明示的に確認した場合に限り実行でき、テナントごとの自己学習が可能になります。
playbook_write	書き込み	実証済みの戦略（トリガー → 効果があった方法）を保存します。重複排除され、毎晩クレジットスコアが付与されます。

memory_write は、重複を排除する双時制の追記処理であり、過去の事実を削除したり上書きしたりすることはありません。 パラメーターの詳細を含むリファレンス：https://ultramemory.io/docs/tools/

その他の接続方法

ワンクリックで開始 — OAuth を使って Claude、ChatGPT、または Perplexity を UltraMemory に接続できます。キーもセットアップも不要です。 ホスト型サーバーは、エンドツーエンドで OAuth 2.1（PKCE） を使用するため、ブラウザベースのクライアントは API キーなしでサインインできます。以下のターミナル／CLI クライアントは、同じエンドポイントに um_ キーを使って接続します。

エンドポイント： https://api.ultramemory.us/mcp（Streamable HTTP） · 認証： ブラウザーコネクターでは OAuth 2.1（PKCE）、CLI クライアントでは Authorization: Bearer um_<key>。

OAuth 優先（ワンクリック、キー不要）

• claude.ai / Claude Desktop — Settings → Connectors → Add custom connector → URL https://api.ultramemory.us/mcp → プロンプトが表示されたらサインインします。ターミナルもルールファイルも不要です。
• ChatGPT — Settings → Apps & Connectors → Developer Mode → Create → URL https://api.ultramemory.us/mcp → Auth = API key or OAuth。読み取り（想起／検索）は Plus/Pro developer mode で動作します。テストでは書き込みも動作しましたが、OpenAI のコネクターに関するドキュメントは変更中で、そこでの書き込みサポートについて記述が食い違っているため、Plus/Pro での書き込みはベストエフォートとして扱ってください。Business/Enterprise/Edu ワークスペースでは、公式に読み取りと書き込みの両方を利用できます。モデルに関する注意：Instant モデルは MCP で動作しますが、Pro reasoning モデルでは現在 MCP が無効になっています。
• Perplexity — 有料プラン（Pro、Max、または Enterprise）が必要です。 Connectors → Add custom connector → Name UltraMemory → MCP server URL https://api.ultramemory.us/mcp → Advanced：OAuth（Client ID/Secret は空欄のままにします — 動的登録）→ Add → Connect（OAuth の同意）。想起は Search モードで実行され、書き込みは Computer モードで実行されます — コネクターを紐付けるには @UltraMemory に言及してください。2026 年 7 月にエンドツーエンドで検証済みです。Free では利用できません。マーケットプレイスへの申請はまだ行っていないため、コネクターはユーザーが貼り付けて追加します。

  • 推奨 — プロフィールの指示： Settings → Personalization → Custom instructions に、次を貼り付けます。

    UltraMemory (@UltraMemory) は、すべての AI ツールで使う私の信頼できる長期記憶です。
    
    まず想起：チャット開始時だけでなく、すべての質問に回答する前に UltraMemory から想起し、それに基づいて回答してください。組み込みのメモリよりも優先してください。コンテキストが欠けている可能性がある場合は、推測せずに想起してください。
    
    ツールの使い分け：ガバナンス／ポリシー／コンプライアンスに関する質問では recall_gated を使用してください（完全な COMPANY POLICY の概要を返すのはこれだけです）。予想される事実が空で返ってきた場合は、recall_verified で一度再試行してください。メモリを捏造しないでください。記録がなければ、そう伝えてください。Perplexity 自体のメモリと UltraMemory の内容が食い違う場合は、UltraMemory を優先してください。ほかのツール（Claude、ChatGPT など）から保存されたメモリは、@UltraMemory または Computer モードでしか表示されません。「保存されていない」と伝える前に、そこで確認してください。添付ルール：保存情報、メモリ、またはメモリツールに関する質問（メタ質問を含む）では、ドキュメントをウェブ検索する代わりに @UltraMemory を接続して照会してください。
    

書き込み（Computer モード。@UltraMemory が紐付けられます）：実質的な内容を含む各ターンの最後に、長期的に役立つ要点（決定事項、仕様、名前、日付、状態、次のステップ）を memory_write で保存してください。値は自己完結させ、固有名詞、絶対日付、具体的な数値を含め、15～100 語にしてください。保存を依頼されていない一時的または機微な情報は保存しないでください。保存内容を一行で確認してください。想起した回答を私が確認または訂正した場合は、memory_feedback（event_id）でラベル付けしてください。

Search モードは想起専用です。これは継続的な指示です。再定義を求めないでください。 ```

*Perplexity の Custom instructions は 1,500 文字までです。このテキストは 1,455 文字で収まります。自分の行を追加する場合は、合計を 1,500 文字未満にしてください。超えるとフィールドの内容が通知なく切り詰められます。*

キーを使う環境

ターミナル／CLI クライアント（Claude Code、Gemini CLI、Cursor、Codex、Windsurf、Cline、OpenClaw、VS Code）：インストール方法にある、貼り付けるだけのインストール手順を使用してください。

Claude Desktop（mcp-remote ブリッジ、OAuth の代わりにキーを使用）：

{ "mcpServers": { "ultramemory": {
  "command": "npx",
  "args": ["mcp-remote@latest", "https://api.ultramemory.us/mcp",
           "--header", "Authorization: Bearer um_YOUR_KEY"]
}}}

Hermes：Hermes の詳細な統合を参照してください。

curl / REST：

curl -s -X POST https://api.ultramemory.us/api/v1/recall \
  -H "Authorization: Bearer um_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"query":"what do you know about my project","k":5}'

OAuth とプラグイン — どちらを選ぶべきですか？

UltraMemory をツールに導入する方法は 2 つあります。まずは 1 つ目から始め、必要に応じて 2 つ目に移行できます。

• OAuth／MCP コネクター（推奨、最も簡単です）。 ワンクリックまたは貼り付け 1 回で利用できます。あらゆる MCP クライアントで 9 つのメモリツールを使えます。最初に想起してから情報を補強し、確信がない場合は正直に回答を控える仕組みを、ローカル環境のセットアップなしで利用できます。まず使い始める場合や、ローカルフックを実行できないブラウザークライアント（claude.ai、ChatGPT、Perplexity）に最適です。
• プラグイン／拡張機能（上級者向け、バンドル版）。 MCP コネクターに加え、最初に想起するルールを同梱した、単一のインストール可能なバンドルです。プラットフォームが対応している場合は、Turbo Token Saver フックと Agent Kit ハーネスも含まれます。より高機能で、インストールは 1 回で済みますが、プラットフォーム固有です。

トークンの無駄を減らしたいですか？ UltraMemory プラグイン（1 行でインストール）により、当社のテストではトークン使用量が約 70％削減されました。さらに、プロジェクトを永続的な根拠のある情報に基づいて固定し、反復を減らして、より速く成果を届け、情報のぶれによるトークンの浪費もなくしたいですか？ UltraMemory Agent Kit を追加してください。効果には個人差があります。

プラグインとは？

プラグイン（プラットフォームによっては拡張機能とも呼ばれます）は、UltraMemory の複数の要素を 1 つのインストールにまとめた、ワンクリックで導入できるバンドルです。メモリーコネクター（9 つのツール）、最初に想起するルール／スキル、そして対応するプラットフォームでは Turbo Token Saver フックと checklist-bound-execution ハーネス（スキル＋サブエージェント）が含まれます。コネクターとルールを別々に貼り付ける代わりに、ひとまとまりとしてインストールできます。

ターンごとの使用量を当社のテストで約 70％削減した（2026-07-05 に測定）トークン節約フックとハーネスのサブエージェントは、ローカルフック／サブエージェントを実行するエージェントランタイムでのみ動作します。Claude Code、Cowork、Hermes、Cline CLI が対象です。 Cowork は claude.ai アカウントで有効になっているコネクターを読み込みます（セッション開始時に同期されます）。claude.ai で UltraMemory を一度追加し、Cowork の Customize サイドバーで有効にしてください。ブラウザーチャットクライアント（claude.ai、ChatGPT、Perplexity）ではコネクターのツールとルールは動作しますが、ローカルフックやサブエージェントは実行されません。そのため、これらの環境におけるプラグインの価値は、フック／ハーネスではなく、コネクターとルールが同梱されている点にあります。効果には個人差があります。この内容は情報提供を目的とするもので、結果を保証するものではありません。

プラットフォーム別プラグイン／拡張機能の仕組み

プラットフォーム	ネイティブのバンドル概念	UltraMemory の利用方法
Claude Code / claude.ai	プラグイン（.claude-plugin）	UltraMemory Agent Kit プラグインです。/plugin marketplace add LogicLabsAI/ultramemory-mcp → /plugin install ultramemory-kit@ultramemory でインストールします。MCP、想起を優先するフック、ハーネススキル／サブエージェントをバンドルしています。
Cursor	プラグイン（Rules/Skills/Subagents/Commands/MCP/Hooks）— Cursor Marketplace + cursor.directory	今すぐホスト型 MCP サーバーに接続できます（Cursor では OAuth ログインが強制され、静的ベアラーが無視される場合があります）。完全な Cursor プラグインバンドルは agent-kit に相当するものです。
Gemini CLI	拡張機能（gemini extensions、gemini-extension.json）	gemini extensions install https://github.com/LogicLabsAI/ultramemory-mcp を実行してから、gemini extensions config ultramemory を実行します（または ULTRAMEMORY_API_KEY をエクスポートします）。このリポジトリには gemini-extension.json と GEMINI.md が含まれています。
OpenAI Codex	プラグイン（.codex-plugin/plugin.json）	config.toml のリモート MCP コネクターを使用します。Codex プラグインバンドルは agent-kit に相当するものです。
VS Code	エージェントプラグイン（プレビュー）+ 拡張機能	mcp.json でリモート MCP サーバーを設定します。VS Code は Claude プラグイン形式も自動検出します。
Cline	プラグイン（cline plugin install）— 現時点では CLI／SDK／Kanban のみ	ネイティブプラグイン（plugins/cline/）は、Cline CLI／SDK／Kanban でのみ cline plugin install を使ってインストールできます。VS Code と JetBrains の拡張機能ではまだプラグインを実行できないため、これらのユーザーはコネクター／マーケットプレイス経由で利用します。
OpenClaw	プラグイン（ネイティブ形式 + Claude 互換バンドル）	ネイティブ MCP コネクターを使用します。Claude 形式の agent-kit バンドルもインストールできます。
Hermes	プラグイン + スキル（memory-provider 種別）	memory-provider プラグイン ultramemory-hermes を使用します。Hermes の詳細な統合を参照してください。
Windsurf	統一された AI バンドルはありません — MCP サーバー + Rules + Workflows	ホスト型リモート MCP サーバー + 想起を優先する .devin/rules/ ルールを使用します（Windsurf 独自の「プラグイン」はエディター拡張機能であり、別のものです）。
Perplexity	統一されたプラグインはありません — コネクター（MCP）+ スキルを個別にインストール。有料	カスタムのリモート MCP コネクター + 想起を優先するスキルを使用します。skills/ultramemory-perplexity/SKILL.md をダウンロードし、Perplexity Computer → Skills → Create skill → スキルをアップロード（Pro/Max/Enterprise）を選択します。

Hermes の詳細な統合

ultramemory-hermes パッケージ（このリポジトリ）は、単なるコネクターではなく、Hermes Agent の完全なメモリープロバイダーです。エージェントのライフサイクルにフックし、各ターンの前に想起を自動注入するとともに、会話から長期保存に適した事実を自動取得するため、モデルがツールの呼び出しを選ばなくてもメモリーが機能します。セッションの終了時には、セッション全体の要約を作成します。ユーザーとアシスタントの両方の発言がサーバーに送信され、サーバーが充実したナラティブカードを1つ作成します（障害要因 → 試した方法 → 成功した方法 → 検証方法）。一方、ターンごとの sync_turn による取得では、生のターン記録が保持されます。

以下の3つの手順でインストールします。

1. pip install ultramemory-mcp（ultramemory-hermes としても公開されています） pip が externally-managed-environment（PEP 668）を報告する場合は、pipx install ultramemory-mcp または uv tool install ultramemory-mcp を実行してください。
2. ultramemory enable --key um_… を実行します。キーを $HERMES_HOME/.env に書き込み、プロバイダーの shim を $HERMES_HOME/plugins/ultramemory/ に配置し、Hermes の設定で memory.provider: ultramemory を選択します。
3. hermes memory status を実行し、プロバイダーがインストール済みとして表示されることを確認します。

Hermes は $HERMES_HOME/plugins/ をディレクトリスキャンしてメモリープロバイダーを検出します。Python のエントリーポイントは参照しないため、ultramemory enable が配置する shim によって、pip でインストールしたプロバイダーが Hermes から認識されます。環境変数を設定するだけでは、プロバイダーをインストールできません。ultramemory enable を実行しないと、スキャンで検出できる shim がディスク上に存在しないためです。元に戻すには ultramemory disable を実行します。shim が削除され、memory.provider が builtin にリセットされます。

メモリスペース（Teams）

Teams、Business、Enterprise アカウントでは、メモリは2層構造です。

• チーム共有レイヤー — ポリシー、プロジェクトのコンテキスト、決定事項など、組織全体のナレッジを オーナー／管理者 が管理します。書き込みができるのはオーナー／管理者のみで、ダッシュボードの「チームナレッジ」コンソールまたは API を使用します。ここにある情報は、すべてのメンバーがすぐに想起できるようになります。
• メンバー個人レイヤー — 各メンバー自身のメモリです。オーナーを含む他のユーザーには見えません。

想起では両方のレイヤーを関連度順の1つのクエリにまとめるため、メンバーは会社のナレッジと自身のコンテキストの両方を自動的に活用できます。Hermes プロバイダーでは、ULTRAMEMORY_SPACE を使って自動取得したメモリの保存先を選択します。

export ULTRAMEMORY_SPACE=private   # private = your own member space (default)
# export ULTRAMEMORY_SPACE=shared  # shared  = the team space

ULTRAMEMORY_SPACE（選択肢：private|shared、デフォルト：private）は、自動書き込み（sync_turn、on_memory_write、on_session_end）の保存先スペースと、memory_write ツールのデフォルトを設定します。自動想起（prefetch、on_pre_compress）では、常にアクセス可能なすべての情報（both）が読み込まれます。

明示的に呼び出すツールでは、デフォルトを上書きする省略可能な呼び出しごとの space 引数も指定できます。

• memory_write — space：private | shared。
• memory_recall / recall_gated — space：private | shared | both（デフォルト：both）。

優先順位： Hermes の agent_workspace が明示的なワークスペース スコープ に解決される場合、そのスコープが優先され、space は無視されます（サーバー側のルールです）。space が適用されるのは、デフォルト（ワークスペース以外）のスコープの場合のみです。

プロジェクトごとのメモリ（スコープ）

1つのアカウント内で、省略可能な scope パラメーターを使うと、プロジェクトやワークスペースごとにメモリを分割できます。明示的なスコープへの書き込みと、そこからの想起のみが行われるため、プロジェクト A のメモリがプロジェクト B に漏れることはありません。

• Hermes — 自動で各エージェントのワークスペースに専用のスコープが割り当てられます。設定は不要です。
• MCP クライアント（claude.ai / Claude Desktop / Cursor） — プロジェクトの指示に1行追加します。「UltraMemory ツールには常に scope='my-project' を渡してください。」
• Claude Code hook — プロジェクトごとに ULTRAMEMORY_SCOPE=my-project を設定します（hooks/README.md を参照）。

scope を省略すると、すべての情報がアカウントのデフォルトを共有します。すべてのツールでメモリが1つになり、個人利用に適したデフォルトです。

Claude Code hooks（想起＋取得）

Hermes を使わずに Claude Code で確実にメモリを使いたい場合は、コピー＆ペーストで導入できる、フェイルオープン方式の2つの hook を使用できます。

• 想起 hook（UserPromptSubmit）— プロンプトを送信するたびに実行され、関連度の高い結果を取得して、モデルが回答する前にコンテキストへ追加します。
• 取得 hook（Stop）— 各ターンの終了時に実行され、ツールの結果を含むターン全体を UltraMemory に送信して、長期的に役立つ事実を抽出します。N 回目のターンごとに（ULTRAMEMORY_SNAPSHOT_EVERY、デフォルトは 5）、バンドルされた ultramemory-snapshot Skill を使って、wayback グレードの セッションスナップショット を作成するようモデルにも促します（Claude Code ≥ 2.1.163）。

どちらもフェイルオープン方式で、コピー＆ペーストですぐに実行できます。コピー＆ペーストで導入できる想起 hook の手順は、上記のインストール方法 → Tier 2にあります。詳細（取得 hook、グローバルインストール、プロジェクトごとのスコープ）は hooks/README.md を参照してください。

トークンのコスト

このリポジトリの SDK クライアント（Claude Code のリコールフックと Hermes プロバイダー）は、リコールのプレビュー階層を利用することで、ホスト型コネクター（claude.ai、Claude Desktop、ChatGPT）の動作を変えずに、ターンごとのトークン消費を数千から数百に削減します（新しい mode / exclude_ids パラメーターは明示的に指定した場合のみ有効です。省略すると従来どおりの動作になります）。

• プレビュー階層 — mode: "preview" を指定してリコールをリクエストします。通常のセクション見出しの下に、各ポリシー以外のファクトを 1 行（- {fact_id} · {entity} · {key}: {first ~120 chars}… (fetch for full)）で表示し、全体を約 2,000 文字に制限します。全文は明示的に fetch すれば取得できます。[COMPANY POLICY] カードは対象外です。プレビューとフルモードのどちらでも、常に全文が表示されます（誤った情報の捏造を防ぐ要となるポリシーは切り詰められません）。
• セッション内の重複排除 — このセッションですでに返された fact_id は exclude_ids として送信されるため、モデルがすでに保持しているファクトに繰り返しターンで予算を消費しません。節約した予算は新しいファクトに回されます。
• クライアントキャッシュ — ~/.ultramemory/cache.json（ultramemory enable によって配置されます。ユーザーによる編集が可能で、権限は chmod 600、LRU により 500 件／約 1 MB に制限されます）。同一のリコールクエリを 5 分間キャッシュします（クエリを再実行しても HTTP 呼び出しはゼロです）。また、各セッションで確認済みの fact_id を 24 時間記録します。リセットするにはファイルを削除してください。破損したファイルは通知なしで再作成されます。

環境変数による設定：

環境変数	デフォルト	効果
ULTRAMEMORY_CACHE=off	on	キャッシュのメモ機能と確認済み項目のキャッシュを完全に無効にするキルスイッチ
ULTRAMEMORY_PREVIEW=off	on	Hermes のプリフェッチをフル（非プレビュー）リコールに戻します
ULTRAMEMORY_HOOK_BUDGET	2000	Claude Code フックのリコール予算（文字数）
ULTRAMEMORY_HOOK_POLICY_BUDGET	12000	[COMPANY POLICY] のターンでフックが注入する内容の上限（ポリシー全文を表示し、切り詰めません）
ULTRAMEMORY_MIN_CONFIDENCE	low	リコールの信頼度がこの値を下回ると、フックは注入をスキップします

UltraMemory を選ぶ理由

• 決定論的なリコール優先設計です。 「まずリコール」はツールの説明と Hermes の自動注入に組み込まれており、モデルが参照するかどうかを判断するのに任せていません。フックは各プロンプトの前に決定論的な注入を試みます（失敗時も処理を継続し、一致度の高い項目を使用します）。エージェントが推論の途中で自ら検索するためのアクティブリコール用 CLAUDE.md ルールと組み合わせたこの 3 つが、リコール優先を実際に保証します。
• 把握していないことについて誠実です。 誤った情報を捏造する代わりに、回答を控えるか確認を求めるメタメモリーゲートを備えています。

ライセンス

Apache-2.0（LICENSE を参照）。これはオープンソースのクライアント部分です。UltraMemory のバックエンド／エンジン（リコールのランキング、メタメモリーゲート、ストレージ、使用量計測、課金）は別個のプロプライエタリなホスト型サービスであり、https://api.ultramemory.us で提供されています。