onboard

Mem0 オンボーディングウィザード

このウィザードを実行して、現在のプロジェクトに mem0 プラグインをセットアップします。所要時間は約60秒です。

重要：手順は必ず順番どおりに（0 → 1 → 2 → 3 → 4 → 5 → 6）実行してください。各手順は前の手順に依存します。手順を並行して実行したり、先へ進んだりしないでください。次の手順を始める前に、現在の手順を完了してください。

手順 0：mem0ai SDK がインストールされていることを確認する

プラグインは、セッション開始時に ${CLAUDE_PLUGIN_DATA}/venv の venv を使って mem0ai Python SDK を自動的にインストールします。手順 5（カテゴリ）でインポートエラーが発生した場合は、次を実行してください。

"${CLAUDE_PLUGIN_ROOT}/scripts/ensure_deps.sh"

このコマンドは何も表示せず、冪等です。いつでも安全に実行できます。

手順 1：API キーを設定する

次のいずれかのソースから API キーを取得できるか確認します。

[ -n "${MEM0_API_KEY:-${CLAUDE_PLUGIN_OPTION_API_KEY:-}}" ] && echo "SET" || echo "NOT_SET"

重要：echo $MEM0_API_KEY は絶対に実行しないでください。シークレットが平文で会話ログに表示されます。

API キーが設定されている場合（出力が「SET」）

- API key found. と表示し、手順 2 に進みます。

API キーが設定されていない場合（出力が「NOT_SET」）

API キーの設定方法をユーザーに案内します。次のメッセージを表示してください。

Step 1: Setting up API key.

- API key not found. Let's set it up.

  1. Get your API key from https://app.mem0.ai/dashboard/api-keys

  2. Choose ONE method:

     Option A — CLI (shell profile):
       echo 'export MEM0_API_KEY="m0-your-key-here"' >> ~/.zshrc
       source ~/.zshrc

     Option B — Desktop app (local environment editor):
       Click the environment dropdown next to the prompt box,
       hover over "Local", click the gear icon, and add:
         MEM0_API_KEY = m0-your-key-here
       (Stored encrypted on your machine, applies to all local sessions)

     Note: The Desktop app does NOT inherit custom env vars from
     shell profiles — it only reads PATH. Use Option B for Desktop.

  3. Verify:
     [ -n "${MEM0_API_KEY:-${CLAUDE_PLUGIN_OPTION_API_KEY:-}}" ] && echo "SET" || echo "NOT_SET"

ユーザーの確認後、確認コマンドを再実行してください。NOT_SET の場合は、同じ手順を繰り返します。SET の場合は、手順 2 に進みます。

手順 2：MCP サーバーへの接続

まず、クエリ "mem0 search_memories" を指定して ToolSearch を使い、MCP ツールがすでに利用可能か確認します。実際のツール名はインストール方法によって異なります（mcp__mem0__search_memories または mcp__plugin_mem0_mem0__search_memories の場合があります）。

MCP ツールが見つかった場合： - MCP already connected. と表示し、手順 3 に進みます。

MCP ツールが見つからない場合：

MCP サーバーは、手順 1 で設定した MEM0_API_KEY を使って認証します。OAuth やブラウザーでのログインは不要です。

1. API キーが設定されていることを確認します（手順 1 のチェックを再実行）
2. プラグインがインストールされていることを確認します：/plugins を実行し、mem0 が表示されることを確認
3. MCP サーバーが一覧にあることを確認します：/mcp を実行し、mcp.mem0.ai を探す
4. サーバーにエラーが表示される場合は、Claude Code を再起動して /mem0:onboard をもう一度実行するようユーザーに依頼
5. すべての確認が完了しているのにツールがまだ見つからない場合：「Claude Code を再起動して、もう一度 /mem0:onboard を実行してください。」

ここで停止してください — MCP ツールなしで先に進まないでください。

手順 3：接続を確認し、ID を表示する

query="project setup"、filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": "<active_project_id>"}]}、top_k=1 を指定して search_memories を呼び出し、接続を確認します。

次を表示します。

- Connected
  user:    <user_id>
  project: <project_id>
  branch:  <branch>

検索に失敗した場合は、API キーと MCP 接続をトラブルシューティングしてください。

手順 4：プロジェクトファイルをインポートする

プロジェクトファイル（CLAUDE.md、AGENTS.md など）は、セッション開始時に自動的に mem0 にインポートされます。この手順ではインポート状況を確認し、必要に応じて再インポートを実行します。

4a：プロジェクトファイルを検出する

for f in CLAUDE.md AGENTS.md .cursorrules .windsurfrules mem0.md; do
  [ -f "$f" ] && echo "FOUND: $f ($(wc -c < "$f") bytes)"
done || true

ファイルが見つからない場合は、- No project files found. Skipping import. と表示し、手順 5 に進みます。

4b：確認してインポートする

ステータスを確認し、必要に応じてインポートするため、フォアグラウンドで auto_import を実行します。

MEM0_DEBUG=1 MEM0_CWD="$PWD" python3 "${CLAUDE_PLUGIN_ROOT}/scripts/auto_import.py"

4c：ユーザーに結果を報告する

auto_import の出力を解析し、ユーザー向けの分かりやすい概要を表示します。

• 出力に Imported の行が含まれる場合：

  - Importing project files into mem0... done.
    <N> file(s) imported (<M> chunks). These are stored verbatim for future context.
  

• 出力に skipping の行のみが含まれる場合：

  - Project files already in mem0 (imported during session start). Verified server-side.
  

• 出力に re-importing が含まれる場合：

  - Project files were missing from mem0. Re-imported successfully.
  

• 出力にエラーが含まれる場合、または処理されたファイルがない場合：

  - Project file import failed. Check API key and retry with: /mem0:onboard
  

ステップ 5：コーディングカテゴリ（自動）

開発ワークフローに最適化されたコーディングカテゴリは、プロジェクトファイルがインポートされるのと同じ方法（ステップ 4）で、セッション開始時にバックグラウンドで自動的にインストールされます。ユーザーへの確認は不要になりました。このステップでは、カテゴリが設定済みであることを確認し、バックグラウンドでの処理がまだ完了していない場合は適用します。

インストーラーはべき等で、独自のキャッシュ機能を備えています。既存のカテゴリと適用予定のカテゴリを比較し、一致する場合は API 呼び出しをスキップします。また、このアカウントに適用済みであれば、以降はタクソノミーに変更がない限り、ネットワーク呼び出しをすべてスキップします。いつでも安全に実行できます。

プラグインの venv python を使用し、フォアグラウンドで実行して確認します。

VENV_PY="${CLAUDE_PLUGIN_DATA}/venv/bin/python3"
if [ -x "${VENV_PY}" ]; then
  MEM0_DEBUG=1 "${VENV_PY}" "${CLAUDE_PLUGIN_ROOT}/scripts/auto_setup_categories.py"
else
  MEM0_DEBUG=1 python3 "${CLAUDE_PLUGIN_ROOT}/scripts/auto_setup_categories.py"
fi

出力を解析します。

• Applied <N> coding categories を含む場合 → 次を出力します。- コーディングカテゴリをインストールしました（<N> 個）。
• already configured を含む場合 → 次を出力します。- コーディングカテゴリはすでに設定済みです。
• エラーまたは SDK not ready の場合 → 先に依存関係インストーラーを実行してから、再試行します。

"${CLAUDE_PLUGIN_ROOT}/scripts/ensure_deps.sh"

その後、カテゴリスクリプトを再試行します。

ステップ 6：概要

概要を出力します。

- Onboarding complete.
  user_id:    <user_id>
  project_id: <project_id> (app_id)
  files:      <N> found, <M> imported
  categories: <installed | already configured>

Memory is now active for this project. Start working — mem0 will
automatically search relevant context and capture learnings.

Run /mem0:tour to see what mem0 already knows about this project.