Amp × Nowledge Mem
ネイティブプラグイン、Context Bundle、MCP形式のツール、スレッドの自動キャプチャにより、ツールをまたいだメモリをAmpに取り込みます。
エージェント向け
この行をAmpに渡してください。 まずユニバーサルインストールスキルを使用する必要があります。 このページは動作とトラブルシューティングのリファレンスとして残ります:
Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Amp. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.AmpはネイティブプラグインAPIを備えたコーディングエージェントです。 Nowledge MemはそのAPIを直接使用します。 AmpはContext Bundle、メモリの検索と保存のツール、グラフの展開、コマンドパレットのアクション、そしてエージェントのターンが終了した後のアクティブなAmpスレッドの自動キャプチャを利用できます。
これはAmp専用の経路です。 Universal Agent Pluginより先にこちらを使用してください。 Ampはホスト固有のライフサイクルイベントとスレッドAPIを公開しており、これらはポータブルなAgent Plugins標準では提供されないためです。
始める前に
- Nowledge Memがローカルで実行されていること(インストール)、または到達可能なリモートMemサーバー
- Ampがインストールされていること
nmemCLIがPATHにあること。 Nowledge MemでSettings → Preferences → Developer Tools → Install CLIに進むか、nmem-cliをインストールしてください
nmem status # Nowledge Mem is reachable
amp --version # Amp is availableセットアップ
プラグインをインストールする
communityリポジトリのルートから:
bash nowledge-mem-amp-plugin/scripts/install.shインストーラーはAmpが所有する3つのエントリを書き込みます:
| パス | 目的 |
|---|---|
${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem.ts | 検出可能なルートプラグインエントリ |
${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem/ | プラグインバンドル |
${XDG_CONFIG_HOME:-$HOME/.config}/amp/skills/nowledge-mem/ | Ampスキルのガイダンス |
XDG_CONFIG_HOMEが設定されている場合、インストーラーは~/.configの代わりにその設定ルートを使用します。
Ampを再起動する
プラグインとスキルが読み込まれるように、Ampを閉じて再度開きます。
統合を確認する
次を実行します:
amp plugins listNowledge Memプラグイン、そのイベント、コマンド、nowledge_mem_*ツールが表示されるはずです。
次に、新しいAmpセッションを開始して尋ねてください:
What was I working on recently?完全な起動コンテキストが重要な場合はAmpがnowledge_mem_context_bundleを呼び出し、より軽量なフォールバックとしてはnowledge_mem_working_memoryを呼び出して、現在のコンテキストを返すはずです。
スレッドのキャプチャを確認するには、短いAmpのターンを終えて、その中のフレーズを検索します:
nmem t search "the phrase you just used" --source ampamp-...スレッドが表示されるはずです。
表示されない場合は、インストーラーを再実行し、Ampを再起動し、NMEM_AMP_AUTO_SYNC=0で自動同期が無効化されていないことを確認してください。
更新
最新のcommunityリポジトリをプルしてから、次を再実行します:
bash nowledge-mem-amp-plugin/scripts/install.sh更新後はAmpを再起動してください。
できること
完全なコンテキストで開始する
Ampはセッションの開始時にContext Bundleを読み込めます。 オーナーのアイデンティティ、AI Identity、アクティブなスペース、Rules、Working Memory、KFSパスなどです。
作業を繰り返す前に検索する
現在のタスクが過去の決定、繰り返し行う手順、以前のデバッグのコンテキストに依存する場合、AmpはMemを直接検索できます。
永続的な知識を保存する
Ampは決定、好み、手順、学びをNowledge Memに保存できるため、他のツールが後でそれらを見つけられます。
関係を探索する
nowledge_mem_graph_expandは、エージェントがある決定が他の決定とどのように関係するかを理解する必要があるときに、メモリの周辺の隣接メモリとラベル付きエッジを表示します。
Ampセッションを検索可能に保つ
各エージェントのターンの後、プラグインはAmpのスレッドAPIを通じて現在のAmpスレッドを読み取り、Mem内の対応するスレッドを書き込みまたは追記します。
ツール
| ツール | 機能 |
|---|---|
nowledge_mem_context_bundle | 起動コンテキストを読み取ります: オーナーのアイデンティティ、AI Identity、アクティブなスペース、Rules、Working Memory、KFSパス。 |
nowledge_mem_working_memory | 今日の軽量なWorking Memoryブリーフィングを読み取ります。 |
nowledge_mem_search | すべてのツールから知識を検索します。ラベル、件数、ディープモードのフィルターをサポートします。 |
nowledge_mem_save | 決定、洞察、手順、好みを保存します。 |
nowledge_mem_update | 既存のメモリを洗練された情報で更新します。 |
nowledge_mem_thread_search | 任意のツールから過去の会話を検索します。 |
nowledge_mem_save_thread | 現在のAmpセッションを完全な会話スレッドとしてオンデマンドで保存します。 |
nowledge_mem_save_handoff | 厳選された引き継ぎサマリーを保存します。 |
nowledge_mem_graph_expand | メモリの周辺のグラフ隣接ノードとラベル付きエッジを展開します。 |
nowledge_mem_status | Nowledge Memの接続性と設定を確認します。 |
セッションキャプチャの仕組み
Nowledge MemはAmpセッションを3つの補完的な方法でキャプチャします:
自動ライブキャプチャ。 Ampのagent.endイベントで、プラグインはAmpのスレッドAPIを通じて現在のスレッドを読み取り、source=ampとして保存します。
キャプチャはスレッドごとに直列化されるため、手動保存と自動保存が競合して重複書き込みになることはありません。
手動による完全なセッションキャプチャ。 nowledge_mem_save_threadはオンデマンドで同じキャプチャ経路を使用します。
これは冪等であり、すぐに保存したい場合にも役立ちます。
厳選された引き継ぎ。 nowledge_mem_save_handoffは、別の場所で再開するための構造化されたサマリーを保存します。
これは完全なトランスクリプトのキャプチャを補完するものであり、唯一の記録ではありません。
リモートMemが機能するのは、プラグインがAmpのトランスクリプトを所有するマシン上で実行され、その後設定されたMemサーバーにアップロードするためです。 リモートMemサーバーは、それ自体でローカルのAmpセッションをスキャンすることはできません。
設定
ローカルでの使用には設定は不要です。
| 環境変数 | デフォルト | 機能 |
|---|---|---|
NMEM_API_URL | (ローカル) | リモートNowledge MemサーバーのURL |
NMEM_API_KEY | (なし) | リモートアクセス用のAPIキー |
NMEM_SPACE / NMEM_SPACE_ID | (なし) | このAmpセッションのアンビエントスペース |
NMEM_AGENT_ID | (なし) | この実行のための安定したNowledge AI Identity |
NMEM_HOST_AGENT_ID | (なし) | 高度な外部エイリアスマッピング |
NMEM_AMP_AUTO_SYNC | 1 | 自動セッションキャプチャを無効にするには0、false、off、またはnoに設定します |
NMEM_AMP_AUTO_SYNC_DEBOUNCE_MS | 1500 | 自動キャプチャのデバウンスウィンドウ |
永続的なリモートアクセスのために、Ampを実行しているマシンで一度設定します:
nmem config client set url https://your-server
nmem config client set api-key your-keyAmpプラグインは、nmemと同じ共有Nowledge Memクライアント設定を読み取ります。
安全にカスタマイズする
インストールされたプラグインバンドルではなく、Amp自身の指示サーフェスを使用してください:
- プロジェクトルール:
AGENTS.md - 個人のグローバルルール:
~/.config/amp/AGENTS.md
~/.config/amp/plugins/nowledge-mem/配下のファイルを直接編集しないでください。
コネクタを更新したい場合はインストーラーを再実行してください。
トラブルシューティング
プラグインが読み込まれない。 bash nowledge-mem-amp-plugin/scripts/install.shを再実行し、~/.config/amp/plugins/nowledge-mem.tsが存在することを確認してから、Ampを再起動してください。
ツールが見つからない。 amp plugins listを実行してください。
プラグインが存在しない場合、Ampはエントリポイントを読み込んでいません。
プラグインが存在するのにツールがない場合は、Ampを更新してプラグインを再インストールしてください。
nmemが見つからない。 デスクトップアプリのDeveloper Tools画面からCLIをインストールするか、nmem-cliをインストールしてから、nmem statusを実行してください。
スレッドが表示されない。 新しいAmpのターンを終え、agent.endキャプチャが実行されるのを待ってから、nmem t search ... --source ampで検索してください。
それでも空の場合は、NMEM_AMP_AUTO_SYNCを確認し、手動の診断としてnowledge_mem_save_threadを一度実行してください。
関連
- コネクタの概要
- Universal Agent Plugin
- OpenCode · Claude Code · Codex
- Ampドキュメント: Plugin API