メインコンテンツへ移動
Nowledge MemNowledge Mem

Cursorでセッションをまたいで記憶を使う

CursorからNowledge Memに接続し、保存したプロジェクトの背景を次のセッションでも参照します。ローカルプラグインを導入し、起動時のコンテキストと記憶検索を確認します。

エージェント向け

この行をエージェントに渡してください。 まずユニバーサルインストールスキルを使用する必要があります。 このページは動作とトラブルシューティングのリファレンスとして残ります:

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Cursor. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.

今日のおすすめ:ローカルプラグインインストール

今日最も信頼できる方法は~/.cursor/plugins/local/nowledge-mem-cursorからのローカルインストールです。 Marketplaceの承認前でも機能し、後で公開するのと同じパッケージを使用します。

Marketplace は後でオプション

Nowledge Memが最終的にあなたのアカウントのCursor Marketplaceに表示されるようになったら、後でその方法に切り替えることができます。 以下のローカルパッケージの方法が、今すぐユーザーが利用できる方法です。

実用的なメリットはシンプルです:一度インストールして、新しいエージェントセッションを開始すれば、Cursorはルール、スキル、フック、MCPの配線をまとめて取得します。

始める前に

  • Nowledge Memがローカルで実行中(インストール)または到達可能なリモートMemサーバー
  • Cursor IDEがインストール済み
  • 推奨:ターミナルツールを通じて自動Context Bundle / Working Memoryブートストラップと再開可能なハンドオフ作成を希望する場合、PATHにnmemを設定

Nowledge Memがデスクトップアプリを通じて同じマシンですでに実行中の場合、最も簡単な方法はSettings → Preferences → Developer Tools → Install CLIです。 これによりCursorがnmemにアクセスでき、セッション開始時のContext Bundle / Working Memoryブートストラップと明示的なハンドオフ作成が可能になります。

実際のCursor Agentスレッド履歴については、Memは~/.cursor/projectsからCursorのローカルAgentトランスクリプトファイルを読み取ります。 デスクトップアプリは同じマシン上でそれらを自動同期できます。 意図的なバックフィルの場合は、まずプレビューします:

nmem t sync --from cursor --all-projects

リストを確認した後にインポートします:

nmem t sync --from cursor --all-projects --apply

1つのプロジェクトだけを対象にする場合は、そのトランスクリプトフォルダを指定します:

nmem t sync --from cursor --session-dir ~/.cursor/projects/Users-me-project/agent-transcripts --apply

1分セットアップ

パッケージフォルダをクローンまたは開く

git clone https://github.com/nowledge-co/community.git
cd community

プラグインをCursorのローカルプラグインフォルダにコピーする

mkdir -p ~/.cursor/plugins/local
rm -rf ~/.cursor/plugins/local/nowledge-mem-cursor
cp -R nowledge-mem-cursor-plugin ~/.cursor/plugins/local/nowledge-mem-cursor

より高速なローカルイテレーションを希望する場合は、代わりにシンボリックリンクを試すことができます:

ln -s "$(pwd)/nowledge-mem-cursor-plugin" ~/.cursor/plugins/local/nowledge-mem-cursor

Cursorのスタッフは、ローカルプラグインのシンボリックリンク解決が現在実際にはバグがあることを確認しているため、コピー優先が信頼できる方法です。

Cursorをリロードする

Cursorを再起動するか、Developer: Reload Windowを実行します。

CursorがまだClaude Codeの文言や古いプラグインIDを表示している場合は、まずCursorから古いインポート済みnowledge-memパッケージを削除してください。 このパッケージは、Nowledge Memスキルに加えて、起動コンテキスト用のsessionStartフックと自動トランスクリプトキャプチャ用のstopフックを公開します。 ローカルプラグインIDは、そのインポート済みパッケージとの衝突を避けるために特にnowledge-mem-cursorです。

新しいエージェントセッションを開始する

デフォルトの同一マシンセットアップでは、バンドルされたプラグインアセットが意図されたゼロ設定の方法です:

  • プラグインマニフェスト
  • ルール
  • スキル
  • セッション開始フック
  • ローカルmcp.json

nmemがインストールされている場合、セッション開始フックはエージェントが開始する前に新しいCursorセッションにWorking Memoryをプリロードできます。

リモートMemのみのMCPを設定する

リモートMemを使用する場合のみ、Settings(Cmd/Ctrl+Shift+J)-> Features -> Model Context Protocolを開き、nowledge-memサーバーURLとヘッダーを更新します。

sessionStartフックとsave-handoffスキルもリモートMemに対して機能させたい場合は、ローカルnmemクライアントを同じリモートサーバーに向けます:

nmem config client set url https://your-server
nmem config client set api-key your-key

この分割は意図的なものです:

  • Cursor MCP設定はプラグインのメモリツールを駆動します
  • nmem config client ...はこのマシン上のターミナル側ブートストラップとハンドオフフローを駆動します

更新

ローカルプラグインフォルダを通じてインストールした場合:

  • 推奨されるコピー方法:~/.cursor/plugins/local/nowledge-mem-cursorを新しいコピーに置き換え、Cursorをリロードします
  • オプションのシンボリックリンク方法:最新のcommunity変更をプルしてCursorをリロードしますが、Cursorがプラグインを検出しなくなった場合はコピーインストールに戻してください

後でMarketplaceサポートが登場した場合は、ローカルコピーをアンインストールしてMarketplaceに移行できます。

安全にカスタマイズする

動作変更にはCursor独自のルールファイルを使用します:

  • .cursor/rules/*.mdc
  • .cursorrules

パッケージ化されたNowledge Memルールをデフォルトとして保持します。 ~/.cursor/plugins/...の下のインストール済みプラグインファイルにパッチを当てないでください。 完全なマップ:統合動作のカスタマイズ。

最初の成功状態

プラグインが正しくセットアップされていることがわかるのは、次の場合です:

  • プラグインが~/.cursor/plugins/local/nowledge-mem-cursorからインストールされている
  • 新しいCursorエージェントセッションを開始する
  • nmemがインストールされている場合、セッション開始時にWorking Memoryがすでに利用可能である
  • 同一マシンセットアップがMCP設定を手動編集せずに機能する
  • リモートモードでは、nowledge-mem MCPサーバーを更新するだけで同じ動作を復元できる
  • Cursorがsave-thread、beforeSubmitPrompt、stopなどの古いClaude指向のパッケージ表面を表示していない

得られるもの

  • バンドルされた.cursor-plugin/plugin.json
  • sessionStart Context Bundle / Working Memoryブートストラップを備えたバンドルされたhooks/hooks.json
  • ローカルNowledge Mem MCP接続用のバンドルされたmcp.json
  • Working Memory、ルーティングされたリコール、蒸留、ハンドオフセマンティクスのための常時オンのルール
  • 4つのスキル:read-working-memory、search-memory、distill-memory、save-handoff
  • Memデスクトップ自動同期またはnmem t sync --from cursorを通じた実際のCursor Agentトランスクリプトインポート

ユーザーが通常気にする点

新規インストールの場合、重要な答えはシンプルです:

  • ローカルMem:プラグインをインストールして新しいセッションを開始します
  • リモートMem:プラグインをインストールし、nowledge-mem MCPサーバーURLとヘッダーを更新します。 ブートストラップとハンドオフも希望する場合は、nmemも同じリモートサーバーに向けます
  • 最高のCursor体験:nmemをインストールしたままにして、セッション開始フックがWorking Memoryをプリロードし、Cursorが必要に応じてハンドオフサマリーを作成できるようにします

重要な制約

パッケージには、明示的なフォールバックとしてsave-threadと、簡潔な再開可能なサマリー用のsave-handoffが含まれています。

そのstopフックは、Cursorがトランスクリプトパスを提供するときに現在のCursor Agentトランスクリプトを自動的にキャプチャします。 Memデスクトップとnmem t sync --from cursorは、履歴または見逃したセッションのために引き続き利用可能です。 両方の方法はCursorのローカルagent-transcripts JSONLファイルを読み取り、重複排除されたメッセージをMemに追加します。

パッケージの形状

このパッケージはすでにCursorのプラグイン形式で配置されています:

.cursor-plugin/plugin.json
rules/nowledge-mem.mdc
skills/*/SKILL.md
hooks/hooks.json
hooks/session-start.mjs
mcp.json

Cursorのローカルプラグインフォルダは、パッケージルートに.cursor-plugin/plugin.jsonを期待します。 このパッケージはすでにその契約に一致しているため、上記のローカルインストール方法は安定して直接的です。

後でMarketplace

後でCursor Marketplaceがパッケージを受け入れた場合は、そこでNowledge Memをインストールし、同じ動作を維持します。 それまでは、ローカルプラグインフォルダがユーザーにとって適切な方法です。

このページの内容