check-integration

コネクターの確認

Nowledge Mem が実行中かどうかを確認し、エージェントに最適なコネクターを案内します。

使用する場面

• Nowledge Mem のセットアップまたは設定について質問されたとき
• メモリツールが動作しない、または利用できないとき
• 「メモリは動作していますか？」や「Nowledge Mem をセットアップするにはどうすればよいですか？」と質問されたとき
• このエージェントで Nowledge Mem を初めて使用するとき
• スキルからネイティブコネクターへのアップグレードについて質問されたとき

ステップ 1：nmem CLI を確認する

nmem --json status

修復を行う前に、次のルールに従ってください。

• Nowledge Mem Desktop と同じマシンの場合： デスクトップアプリに同梱されている nmem を使用してください。Nowledge Mem を開くようユーザーに案内し、コマンドがまだ見つからない場合は、Settings → Preferences → Developer Tools → Install bundled CLI を使用してください。
• 別のマシンの場合： このマシンにスタンドアロンの PyPI パッケージ nmem-cli をインストールし、ユーザーの Mem サーバーに接続してください。リモートサーバー、開発用マシン、CI ランナー、ホスト型エージェント、SSH マシンが対象です。Python 3.11 以降が必要です。

ユーザー自身のデスクトップでは、ユーザーがスタンドアロン CLI を明示的に求めない限り、デスクトップに同梱されている CLI の上から PyPI CLI をインストールしないでください。

エージェントがデスクトップマシン上におらず、nmem が見つからない場合は、PyPI CLI をインストールしてください。

python3 -m pip install --user nmem-cli
# or: pipx install nmem-cli
# or for one-off checks: uvx --from nmem-cli nmem --json status

nmem config client set url https://<their-mem-server>
nmem config client set api-key nmem_...
nmem --json status

nmem が存在するのにステータス確認に失敗する場合、このマシンから Nowledge Mem に接続できていません。ユーザーに次のように案内してください。

• ローカルデスクトップ：Nowledge Mem アプリを開いてから、nmem --json status を再試行してください
• リモート／クライアントマシン：nmem config client show で URL／API キーを確認してください
• インストールの全手順：https://mem.nowledge.co/docs/installation
• リモートアクセスのガイド：https://mem.nowledge.co/docs/remote-access

ステップ 2：エージェントを特定し、最適な方法を推奨する

新規インストールの場合は、汎用接続スキルから始めてください。

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for the AI tool I am using.

この統合確認スキルを診断時の代替手段として使用してください。何がインストールされたかを確認し、ユーザーが期待できる動作を説明し、問題が発生した場合は設定を修復してください。

「X をインストールしてください」と答えるだけではいけません。ユーザーが得られる動作上の保証を説明してください。

1. 自動的に開始されるもの
2. スキル／ルールによる案内にとどまり、引き続きモデル主導で動作するもの
3. スレッドが自動的に記録されるのか、明示的に保存されるのか、引き継ぎ用の要約としてのみサポートされるのか

次の優先順位に従ってください。

1. ホストにネイティブコネクターがある場合は、ネイティブコネクターを最優先
2. ホストが Agent Plugins に対応しており、ネイティブコネクターがない場合は、Universal Agent Plugin
3. ホストが MCP に対応しており、より適したパッケージ経路がない場合は、直接 MCP
4. ホストが共有スキル／プロンプトに対応しており、ネイティブコネクター、Agent Plugins 対応、MCP ツールのインターフェースがない場合は、再利用可能なパッケージ

新規ユーザーが重視するのは、通信方式ではなく得られる結果です。セットアップ後に実際に何ができるようになるかを説明してください。

自律性のレベル

経路	通常の動作	保証されないこと
ネイティブコネクター	最も強力なセットアップです。セッションのブートストラップは多くの場合自動で、一部のホストでは自動記録やフック駆動の想起も追加されます	積極的な想起／蒸留の正確なタイミングは、ホストによって異なる場合があります
Universal Agent Plugin	専用コネクターのない互換クライアント向けに、共有スキルとローカル Mem MCP を組み合わせた標準的な Agent Plugins パッケージです	Agent Plugins 1.0 では、移植可能なライフサイクルフックやトランスクリプトへのアクセスは提供されません
直接 MCP	ツールを利用できます。推奨プロンプトブロックを使用すれば、エージェントは積極的にツールを使えます	MCP だけでは、ホストによって強制される自律性は実現しません
再利用可能なパッケージ	Working Memory、想起、蒸留をルール／スキルで案内します	プロンプトやプロジェクトのガイダンスが十分でないと、ホストがその案内を無視する場合があります

使用中のエージェントを確認し、利用可能であればネイティブコネクターを推奨してください。

この表の正式な情報源は community/integrations.json です。

エージェント	検出方法	コネクターのセットアップ	ドキュメント
Claude Code	Claude Code エージェントとして実行中です。~/.claude/ が存在します	claude plugin marketplace add https://github.com/nowledge-co/community && claude plugin install nowledge-mem@nowledge-community	ガイド
Grok	Grok として実行中です。~/.grok/ が存在します	grok plugin install nowledge-co/community#nowledge-mem-claude-code-plugin --trust	ガイド
Grok Bot	クラウドホスト型の Grok Bot を設定中です。ローカル CLI のインストールは想定されていません	Grok Bot の設定で、公開 HTTPS エンドポイントを使用するカスタム Nowledge Mem MCP コネクターを追加します。Bot またはチームに互換性のある Plugins 設定がある場合は、対応するスキル／フック用に共有パッケージをそこで有効にします。localhost や 127.0.0.1 は使用しないでください。スレッド全体の自動キャプチャには、文書化された Bot のトランスクリプトエクスポートまたはフックのペイロードが引き続き必要です。	ガイド
OpenClaw	OpenClaw エージェントとして実行中です。~/.openclaw/ が存在します	openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem	ガイド
Cursor	Cursor IDE 内で実行中です	コミュニティリポジトリから nowledge-mem-cursor-plugin を ~/.cursor/plugins/local/nowledge-mem-cursor にコピーし、Cursor を再読み込みします	ガイド
Gemini CLI	Gemini CLI エージェントとして実行中です。~/.gemini/ が存在します	gemini extensions install https://github.com/nowledge-co/nowledge-mem-gemini-cli --auto-update を実行するか、Extensions Gallery から「Nowledge Mem」をインストールします	ガイド
Google Antigravity	Antigravity として実行中です。~/.gemini/config/plugins/ または ~/.gemini/antigravity/ が存在します	ネイティブプラグインをインストールします：mkdir -p ~/.gemini/config/plugins && git clone --depth 1 https://github.com/nowledge-co/nowledge-mem-google-antigravity.git ~/.gemini/config/plugins/nowledge-mem を実行し、Antigravity を再起動します。リモート Mem の場合は、nmem config mcp show --host google-antigravity を実行し、生成された serverUrl MCP ブロックを Antigravity の MCP 設定に貼り付けます。古い履歴をプレビューするには nmem t sync --from antigravity を使用します。Trajectory Extractor は、キャッシュにのみ残っている古いセッションに限って使用します。	ガイド
Alma	Alma 内で実行中です。~/.config/alma/ が存在します	Alma で、Settings > Plugins > Marketplace を開き、「Nowledge Mem」を検索します	ガイド
Droid	Droid（Factory）内で実行中です	nowledge-co/community マーケットプレイスを追加し、nowledge-mem@community をインストールします	ガイド
OpenHands	OpenHands または OpenHands SDK 内で実行中です	Plugin.load("path/to/nowledge-mem-openhands-plugin") で nowledge-mem-openhands-plugin を読み込むか、.openhands/plugins/nowledge-mem にコピーします。	パッケージガイド
CodeBuddy	CodeBuddy Code 内で実行中です	codebuddy plugin marketplace add nowledge-co/community && codebuddy plugin install nowledge-mem@nowledge-community を実行し、CodeBuddy を再起動します	ガイド
WorkBuddy	WorkBuddy 内で実行中です	デスクトップの Plugins -> + で https://raw.githubusercontent.com/nowledge-co/community/main/.workbuddy-plugin/marketplace.json を追加し、Nowledge Mem をインストールして有効にしてから再読み込みし、MCP の Trust を確認します。プラグインカードの Update を使用してください。プラグインのスラッシュコマンドは、ホストが公開している場合にのみ代替手段となります。	ガイド
Codex	Codex デスクトップまたは Codex CLI 内で実行中です。~/.codex/ が存在します	codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin && codex plugin add nowledge-mem@nowledge-community を実行し、[features] plugins = true、hooks = true、および [plugins."nowledge-mem@nowledge-community"] enabled = true を有効にしてから、インストール済みの scripts/install_hooks.py を実行します。ホストで引き続き必要な場合に限り、従来の plugin_hooks ゲートも追加されます。Codex を再起動し、求められたら Nowledge Mem フックを信頼します。Codex のローカル Memory が有効な場合は、Allow memory generation from tool-assisted tasks をオフにします。	ガイド
Bub	Bub 内で実行中です	pip install nowledge-mem-bub	ガイド
Pi	Pi エージェントとして実行中です。~/.pi/ が存在します	pi install npm:nowledge-mem-pi	ガイド
DimAgent	DimAgent 内で実行中です。~/.dim/ が存在するか、DIMCODE_HOME が設定されています	ネイティブ DimAgent インポートに対応した Mem リリースにアップグレードしてから、DimAgent の Codex 互換プラグインフローで nowledge-mem-dimagent-plugin をインストールし、DimAgent を再起動します。求められたらライフサイクルフックを信頼します。ホスト固有のマーケットプレイスコマンドは、まだ検証済みのものが公開されていません。	パッケージガイド
OMP	OMP エージェントとして実行中です。~/.omp/ が存在します	omp plugin install nowledge-mem-omp	ガイド
OpenCode	OpenCode エージェントとして実行中です。~/.config/opencode/ または .opencode/ が存在します	opencode --version を確認します。1.x： opencode plugin [email protected] --global。2.x： opencode plugin add opencode-nowledge-mem（デフォルトでグローバル）。フックを読み込むため、OpenCode を再起動します	ガイド
Amp	Amp エージェントとして実行中です。~/.config/amp/ または .amp/ が存在します	bash nowledge-mem-amp-plugin/scripts/install.sh を実行してから、ツール、agent.end キャプチャフック、スキルを読み込むために Amp を再起動します	ガイド
Craft Agent	Craft Agent 内で実行中です。~/.craft-agent/ が存在するか、CRAFT_CONFIG_DIR が設定されています	nmem config mcp show --host craft-agent を実行し、生成されたソース設定とガイドをアクティブな Craft ワークスペースに追加します。実際のセッションをインポートするには nmem t sync --from craft-agent --all-projects --apply を使用します。	ガイド
Hermes Agent	Hermes エージェントとして実行中です。~/.hermes/ が存在します	ネイティブの Hermes プロバイダーをインストールします（または代替手段として MCP のみを使用します）	ガイド
Cradle	Cradle 内で実行中です。プラグインマーケットプレイスにバンドル済みの nowledge-mem インテグレーションが表示されます	Cradle にバンドルされている Nowledge Mem プラグインを有効にします。必要に応じて、API URL、オプションの MCP URL、Space、実行時のみ使用する API キーを設定します。	ガイド
Arkloop	Arkloop 内で実行中です。Settings > Memory に Nowledge が表示されます	Memory を有効にして Nowledge を選択し、ローカルインスタンスを検出するか、Base URL、API Key、タイムアウトを入力します。	ガイド
iCode	iCode（Chrys）内で実行中です。~/.chrys/ が存在するか、CHRYS_SESSION_ROOT_DIR が設定されています	コミュニティリポジトリのチェックアウトから nowledge-mem-icode-plugin/scripts/install.py を実行し、iCode を再起動します。エージェントプロファイルに nowledge-mem MCP サーバーを統合し、user_prompt_submit コンテキストフックをインストールして、共有スキルをコピーします。/agents > MCP と、新しいセッションで最初のプロンプトを実行して確認します。	パッケージガイド
OpticLM	Optic 内で実行中です。拡張機能の設定に Nowledge Mem が表示されます	Optic の組み込みインテグレーションを有効にします。Working Memory、検索、永続メモリのツールも必要な場合は、Mem MCP を別途直接追加します。	ガイド
Hermes を更新するには、ガイドに記載されたセットアップコマンドを実行し、Thread import endpoint: /threads/import と表示されることを確認してください。古いエンドポイントが表示される場合や、エンドポイントが表示されない場合は、別の HERMES_HOME で Hermes を起動している可能性があります。HERMES_HOME を明示的に設定してから、再起動する前にセットアップを再実行してください。

エージェントが上記に記載されていない場合：

• ホストが Agent Plugins に対応している場合は、Universal Agent Plugin を使用してください
• それ以外の場合は、直接 MCP を使用し、推奨されるプロンプトブロックを追加してください
• ホストが共有スキルには対応しているものの、MCP ツールを利用できない場合は、共有の npx skills パッケージを使用してください

生の MCP がネイティブコネクターと同等であると説明しないでください。

ステップ 3：確認

セットアップ後、次の方法で確認してください。

nmem --json m search "test" -n 1

結果が返される場合（エラーのない空のリストを含む）、コネクターは動作しています。

次に、期待される動作を平易な言葉で説明してください。

• 作業メモリ：自動、ガイド付き、または手動
• 想起：自動、ガイド付き、または手動
• 要約：自動、ガイド付き、または手動
• スレッド：自動キャプチャ、明示的な保存、引き継ぎのみ、またはなし

利用経路が guided のみの場合は、次のうち何がその利用経路を強化するかを説明してください。

• nmem をローカルで使用できる状態にしておく
• インストール後にホストを再起動する
• 推奨される場合は、パッケージの AGENTS.md または同等のリポジトリガイダンスを統合する
• リモートモードでローカルの nmem クライアントを設定する

ネイティブコネクターで追加される機能

スキルを使うと、コマンドラインからメモリにアクセスできます。ネイティブコネクターでは通常、次の機能が追加されます。

• 自動想起：各応答の前に関連するメモリを挿入します（手動検索は不要です）
• 自動記録：セッション終了時に、会話を検索可能なスレッドとして保存します
• LLM による要約：重要な決定事項や知見を自動的に抽出します
• グラフツール：つながり、変化の連鎖、エンティティ間の関係を調べます
• 作業メモリ：セッション開始時に、日次ブリーフィングを読み込むか挿入します
• スラッシュコマンド：/remember、/recall、/forget（対応している場合）

これらすべてが、あらゆるホストで利用できると約束しないでください。ユーザーが設定している実際の利用経路に合わせてください。

リンク

• すべてのコネクター
• ドキュメント
• Discord コミュニティ