OpenCode × Nowledge Mem
クロスツールの知識をOpenCodeに取り込み、OpenCodeで学んだことを他のすべてのツールと共有します。
エージェント向け
この行をエージェントに渡してください。 まずユニバーサルインストールスキルを使用する必要があります。 このページは動作とトラブルシューティングのリファレンスとして残ります：
Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for OpenCode. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.opencode --versionopencode plugin opencode-nowledge-mem@0.3.10 --globalopencode plugin add opencode-nowledge-memOpenCodeはターミナル向けコーディングエージェントです。 Nowledge Memはその上にレイヤーを追加します。 他のすべてのAIツールからの知識、Claude Codeで下した決定、Cursorで設定した好み、ChatGPTからの洞察を、OpenCode内で検索できます。 新しいOpenCodeセッションもOpenCodeがアイドル状態になった後にキャプチャされるため、そこで学んだことがツールを切り替えることなく、後のリコールや結晶化に活かせます。
始める前に
- Nowledge Memがローカルで実行されていること（インストール）、または到達可能なリモートMemサーバー
- OpenCode 2.xがインストールされていること。
OpenCode 1.xのユーザーはプラグイン
0.3.10を使い続けてください。 以下の互換性に関する注記を参照してください。 nmemCLIがPATHにあること。 Nowledge MemでSettings → Preferences → Developer Tools → Install CLIに移動するか、pip install nmem-cli
nmem status # Nowledge Mem is running
opencode --version # OpenCode is availableセットアップ
プラグインをインストールする
opencode --versionを確認し、一致するコマンドを使用してください。
OpenCode 2.xはグローバル設定にインストールします：
opencode plugin add opencode-nowledge-memこのコマンドはパッケージをグローバルにインストールし、OpenCodeのグローバルプラグイン設定に追加します。
設定を手動で編集したい場合は、プラグイン名を自分で追加してください：
{
"plugins": ["opencode-nowledge-mem"]
}OpenCode 1.xは古いプラグインAPIを使用します。
まだOpenCodeをアップグレードしていない場合は、最後の互換リリースをレガシーのplugin配列に保持してください：
opencode plugin opencode-nowledge-mem@0.3.10 --global{
"plugin": ["opencode-nowledge-mem@0.3.10"]
}OpenCodeを再起動する
OpenCodeを閉じて再度開き、プラグインを読み込ませます。
統合を確認する
OpenCodeにNowledge Mem接続の確認を依頼します：
What was I working on recently?完全な起動コンテキストが重要な場合はOpenCodeがnowledge_mem_context_bundleを呼び出し、軽量なフォールバックとしてnowledge_mem_working_memoryを呼び出して、現在のコンテキストを返すはずです。
これが成功です。
OpenCodeは他のツールからの知識を見られるようになりました。
スレッドキャプチャを確認するには、短いターンを終えて、OpenCodeがアイドル状態になってから少し待ちます。 別のターミナルで、そのターンからのフレーズを検索します：
nmem t search "the phrase you just used" --source opencodeopencode-...スレッドが表示されるはずです。
表示されない場合は、プラグインを更新してOpenCodeを再起動し、イベントフックを読み込ませてください。
更新
グローバルプラグインパッケージを更新し、インストール済みのコピーを置き換えます：
opencode plugin opencode-nowledge-mem@0.3.10 --global --forceopencode plugin update opencode-nowledge-mem安全にカスタマイズする
インストール済みのプラグインファイルではなく、OpenCode自身の指示サーフェスを使用してください：
- このプロジェクトで共有の動作が必要な場合は、リポジトリ内の
AGENTS.md - 個人のデフォルトには
~/.config/opencode/AGENTS.md - ファイルベースのガイダンスではなくホストレベルの設定が必要な場合は、
opencode.json内のinstructions
インストール済みのNowledge Memプラグインパッケージを直接編集しないでください。 ホストごとの完全なマップについては、統合の動作をカスタマイズするを参照してください。
できること
他のツールからの知識を見つける
「データベースについて何を決めたっけ？」と尋ねると、OpenCodeはこのセッションだけでなく、Claude Codeで下した決定、ChatGPTからの洞察、Cursorからのノートを横断して検索します。
あらゆる場所のために知識を保存する
OpenCodeで結論に達したとき、エージェントがそれを保存するので、次のClaude Codeセッション、Cursorプロジェクト、ChatGPTの会話でも見つけられます。
今日のコンテキストから始める
Context Bundle、Working Memoryブリーフィング、関連する過去の知識が、ツールをまたいで同じことを繰り返す前に利用できます。
セッション全体を検索可能に保つ
OpenCodeがターンを終えてアイドル状態を報告すると、プラグインはセッションをMemスレッドとして保存します。 長いセッションはコンパクションの前にもフラッシュされるため、トランスクリプトは検索、レビュー、後の知識の結晶化のために利用可能なままです。
再開可能なハンドオフを作成する
OpenCodeで締めくくり、Claude Codeや他のツールで中断したところからそのまま再開できます。 決定、計画、コンテキストは自動的に引き継がれます。
ツール
| ツール | 機能 |
|---|---|
nowledge_mem_context_bundle | 起動コンテキストを読み取ります：オーナーID、エージェントID、アクティブスペース、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 | 現在のセッションを完全な会話スレッドとしてオンデマンドで保存します。新しい作業では通常、自動アイドルキャプチャがこれを処理します。 |
nowledge_mem_save_handoff | 厳選されたハンドオフサマリー（より軽量で、エージェントが作成）を保存します。 |
nowledge_mem_status | Nowledge Memサーバーの接続性と診断を確認します。 |
セッションキャプチャの仕組み
Nowledge MemはOpenCodeセッションを4つの補完的な方法でキャプチャします：
プラグインによる自動ライブキャプチャ。 OpenCodeがsession.status=idle（または古いsession.idleイベント）を報告すると、プラグインはメッセージがフラッシュされるのを少し待ち、OpenCodeのSDKを通じて現在のセッションを読み取り、一致するopencode-...スレッドをMemに書き込みます。
新しい作業ではこの経路に頼るべきです。
コンパクション前のフラッシュ。 OpenCodeが長いセッションをコンパクト化する前に、プラグインは同じスレッド経路を通じて現在のトランスクリプトを保存します。 通常のコンテキストフックは、次のエージェントループリクエストでNowledge Memのガイダンスを復元します。
手動による完全セッションキャプチャ。 nowledge_mem_save_threadはOpenCodeのSDKクライアントを通じて現在のセッションのメッセージを読み取り、HTTP経由でNowledge Memに投稿します。
複数回実行しても安全で、明示的なフォールバックとして引き続き有用です。
プラグインによるプロアクティブな知識保存。 nowledge_mem_saveは会話中に個々の決定や洞察をキャプチャし、source=opencodeのスタンプを付けます。
nowledge_mem_save_handoffは締めくくり時に厳選されたサマリーを作成します。
どちらも、焦点を絞った価値の高い要点で完全なトランスクリプトを補完します。
デスクトップインポートはOpenCodeのローカルデータベースを直接読み取るため、Memが実行されているマシン上のセッションしか見えません。
リモートモードでは、ネイティブプラグインのライブキャプチャを使用するか、OpenCodeがセッションを保存しているクライアントマシンでnmem t syncを実行してください。
古いセッションをインポートする
古いOpenCodeセッションをバックフィルするには、まずプレビューします：
nmem t sync --from opencode --all-projects --limit 20次にインポートします：
nmem t sync --from opencode --all-projects --apply1つのプロジェクトだけが必要な場合は、--all-projectsの代わりに-p /path/to/projectを使用してください。
このコマンドは、このマシン上のOpenCodeのローカルセッションデータベースまたはレガシーJSONストレージを読み取り、nmemで設定されたMemサーバーに書き込みます。
インポートされた履歴はすぐに検索可能になります。
より深い蒸留は明示的なレビューステップのままです。
設定
ローカルでの使用には設定は不要です。
| 環境変数 | デフォルト | 機能 |
|---|---|---|
NMEM_API_URL | (ローカル) | リモートNowledge MemサーバーのURL |
NMEM_API_KEY | (なし) | リモートアクセス用のAPIキー |
永続的な共有セットアップには、nmem config client ...でこのマシンを一度設定してください。
一時的な上書きが必要な場合は、環境変数が引き続き優先されます。
リモートアクセス
nmem config client set url https://your-server
nmem config client set api-key your-keyOpenCodeは、nmemコマンドツール、自動アイドルキャプチャ、手動セッションキャプチャ、履歴同期に同じ共有設定を使用します。
どこからでもMemにアクセスするを参照してください。
トラブルシューティング
nmemが見つかりません。 pip install nmem-cliでインストールし、nmem statusを実行して確認してください。
サーバーが応答しません。 Nowledge Memデスクトップアプリを起動するか、診断のためにnmem statusを確認してください。
プラグインが読み込まれません。 まずopencode --versionを確認してください。
1.xではopencode plugin opencode-nowledge-mem@0.3.10 --global --forceを実行します。
2.xではopencode plugin update opencode-nowledge-memを実行し、OpenCode 2.xの設定が返すplugins配列に"opencode-nowledge-mem"が表示されることを確認してから、OpenCodeを再起動します。
OpenCode 1.xでは、レガシーのpluginキーを使用し、@0.3.10を固定してください。
関連
- コネクターの概要
- Claude Code · Pi · Hermes Agent · OpenClaw · Alma
- プラグインソース：nowledge-mem-opencode-plugin