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

Copilot CLI

GitHub Copilot CLIプラグイン。Context Bundle / Working Memoryの起動コンテキスト、ガイド付きリコール、圧縮前およびセッション境界でのセッションキャプチャを提供します。

エージェント向け

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

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Copilot CLI. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.
One-minute install
copilot plugin marketplace add nowledge-co/community
copilot plugin install nowledge-mem@nowledge-community

プラグインネイティブのパス

Copilot CLIはプラグインとライフサイクルフックをサポートしています。 プラグインを一度インストールし、 nmemをローカルで利用可能にしておけば、CopilotはContext BundleまたはWorking Memoryで起動し、 過去のコンテキストが重要になる場面で検索し、ホストが会話を圧縮または終了する前に セッションをMemに追記し続けることができます。

これはGitHub Copilot CLI向けの専用Nowledgeパスです。 汎用MCPよりも Claude Codeに近い構成です。 プラグインが独自のフック、スキル、キャプチャランタイムを 持ち込みます。 同時に、Copilotはモデルを介したスキルをいつ使うかを依然として自分で判断するため、 より強力な能動的リコールと蒸留を望む場合にはAGENTS.mdのようなプロジェクトガイダンスが 役立ちます。

動作しているかどうかの確認方法

新しいCopilotセッションを開始し、What was I working on?と尋ねてください。 最近の フォーカスと優先事項が表示されるはずです。 次にCopilotにセッションの保存またはチェックポイントを 依頼し、そのスレッドがMemに表示されることを確認してください。

始める前に

  • ローカルで実行中のNowledge Mem(インストール)または到達可能なリモートMemサーバー
  • GitHub Copilot CLIがインストールされていること
  • nmem CLIがPATHにあること

セットアップ

nmemをインストールする

# Option 1: use the bundled CLI from the Mem desktop app
# Settings → Preferences → Developer Tools → Install CLI

# Option 2: pip
pip install nmem-cli

# Option 3: pipx
pipx install nmem-cli

次に確認します:

nmem status

Nowledge Memデスクトップアプリを使用するWindowsおよびLinuxでは、nmemはすでにバンドルされています。

プラグインをインストールする

copilot plugin marketplace add nowledge-co/community
copilot plugin install nowledge-mem@nowledge-community

インストール後にCopilot CLIを再起動してください。

プラグインは、自身がパッケージ化したhooks/ ディレクトリからキャプチャランタイムを実行するようになりました。 古いインストールでは、 互換用のコピーがすでに存在する場合、~/.copilot/nowledge-mem-hooks/にフォールバックできます。

必要に応じてWSLブリッジ

Copilot CLIがWSL内で実行されているが、nmemが Memデスクトップアプリを通じてWindowsにインストールされている場合は、WSL内で次のブリッジを作成します:

mkdir -p ~/.local/bin && cat > ~/.local/bin/nmem << 'SHIMEOF'
#!/bin/bash
python3 - "$@" <<'PY'
import subprocess
import sys

cmd = subprocess.list2cmdline(["nmem.cmd", *sys.argv[1:]])
raise SystemExit(subprocess.run(["cmd.exe", "/s", "/c", cmd]).returncode)
PY
SHIMEOF
chmod +x ~/.local/bin/nmem

これにより、WSL内で実行されているCopilotがWindowsのnmemをクリーンに呼び出せるようになります。

より強い自発性を望む場合にプロジェクトガイダンスを追加する

プラグインはContext Bundle / Working Memoryのブートストラップとセッションキャプチャを 自ら処理します。 継続の多いリポジトリでCopilotにさらに能動的に検索または蒸留してほしい場合も、 パッケージのAGENTS.mdをプロジェクトルートにマージしてください:

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
cp /tmp/nowledge-community/nowledge-mem-copilot-cli-plugin/AGENTS.md ./AGENTS.md
rm -rf /tmp/nowledge-community

リポジトリにすでにAGENTS.mdがある場合は、ファイルを上書きせずに Nowledgeセクションをマージしてください。

必要に応じてリモートMemを設定する

nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_key

これは、プラグインとnmemが使用する共有ローカルクライアント設定を書き込みます。

自動的に行われること

プラグインはCopilot CLIフックを次の5つの目的で使用します:

  • SessionStart起動時、再開時、クリア時:nmem --json context --source-app copilot-cliでContext Bundleを読み込み、次にWorking Memoryにフォールバック
  • SessionStart圧縮後:Context BundleまたはWorking Memoryを再読み込みし、重要な発見をチェックポイントするようCopilotに促す
  • UserPromptSubmit:検索と保存のガイダンスを各ターンの近くに保つ
  • Stop:各応答後に記録されたCopilotセッションを非同期でキャプチャ
  • PreCompactおよびSessionEnd:圧縮前およびセッション終了時に最新の記録済みセッションをキャプチャ

キャプチャフックは新しい会話コンテンツのみを追記します。 毎回セッション全体を 再インポートし続けることはありません。

スキル

Copilotプラグインはユーザー向けの表面をシンプルに保ちます。 保存、検索、ステータス用の 別個のコマンドドキュメント層は提供しません。 代わりに、スキルと基盤となるnmem CLIに 依存します。

スキル役立つ場面動作
read-working-memoryセッション開始時、「今何に取り組んでいるか?」利用可能な場合はContext Bundleを、そうでなければ今日のWorking Memoryブリーフィングを軽量フォールバックとして読み込む
search-memory以前の作業、以前の根拠、過去の議論永続的なメモリと過去のスレッドを検索する
distill-memory実際の決定や学びが生まれたとき永続的な知識をMemに保存する
save-thread「このセッションを保存」「これをチェックポイント」明示的な要求時に簡潔なセッションサマリースレッドを保存する

スキルの表面以外で直接トラブルシューティングするには、ターミナルでnmem statusを実行してください。

更新

copilot plugin marketplace add nowledge-co/community
copilot plugin marketplace update nowledge-community
copilot plugin update nowledge-mem

次にCopilot CLIを再起動してください。

安全にカスタマイズする

インストール済みのプラグインを編集するのではなく、Copilot自身の指示ファイルを使用してください:

  • 共有リポジトリルールには.github/copilot-instructions.mdまたは.github/instructions/*.instructions.md
  • リポジトリをまたぐ個人ルールには~/.copilot/copilot-instructions.md

ホストごとの完全なマップについては、統合動作のカスタマイズを参照してください。

トラブルシューティング

nmemが見つからない

nmem-cliをpipまたはpipxでインストールするか、MemデスクトップアプリのバンドルCLIを使用してください。

起動コンテキストがまったく表示されない

インストール後にCopilot CLIを再起動してください。 次にnmem statusを実行して、ローカルクライアントがMemに到達できることを確認してください。

スレッドがMemに表示されない

インストールまたは更新後にCopilot CLIを再起動し、~/.copilot/nowledge-mem-hooks/hook-log.jsonlを確認してください。 古いインストールまたはローカル開発チェックアウトを使用している場合は、互換フォールバックとして ソースツリーからscripts/install-hooks.shを実行することもできます。

Copilotが起動コンテキストを読むだけで、ほとんど検索や蒸留をしない

これは通常、ブートストラップフックは動作しているものの、リポジトリがCopilotに十分に強い 行動ガイダンスを与えていないことを意味します。 プラグインのAGENTS.mdを プロジェクトルートにマージし、継続スタイルの質問で再試行してください。

このページの内容