Codex

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

コンテキストを失うことなく、Codex、Claude Code、Gemini、Cursorを切り替えられます。 Codexパッケージは起動時にContext Bundle / Working Memoryを注入し、ローカルMCPサーバーを同梱し、継続作業を検索に向け、スレッドを自動的にキャプチャします。 Codexは依然として対象を絞った検索が有用かどうかを判断しますが、スキルの説明だけからNowledgeを選択する必要はなくなりました。 だからこそ、推奨されるセットアップはハイブリッドです：プラグイン + MCP + フック。

CodexデスクトップアプリとCodex CLIは、同じ~/.codex設定、プラグインキャッシュ、フック、MCP設定を使用します。 このガイドではcodexコマンドを使用します。 セットアップはCLIで管理されますが、インストールされたコネクタは両方に適用されます。

始める前に

• Nowledge Memがローカルで実行されている（インストール）か、到達可能なリモートMemサーバー
• CodexデスクトップアプリまたはCodex CLIがインストールされている
• nmem CLIがPATHにある

セットアップ

# Option 1: uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

# Option 2: pip
pip install nmem-cli

codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin
codex plugin add nowledge-mem@nowledge-community

codex marketplace add nowledge-co/community

[features]
plugins = true
hooks = true

[plugins."nowledge-mem@nowledge-community"]
enabled = true

HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
if [ -z "$HOOK_SETUP" ]; then
  echo "Hook setup was not found. Open Codex, run /plugins, install nowledge-mem@nowledge-community, then retry."
else
  python3 "$HOOK_SETUP"
fi

$HookSetup = Get-ChildItem "$env:USERPROFILE\.codex\plugins\cache" -Recurse -Filter install_hooks.py |
  Where-Object { $_.FullName -like "*nowledge-mem*" } |
  Sort-Object FullName |
  Select-Object -Last 1
if ($null -eq $HookSetup) {
  Write-Host "Hook setup was not found. Open Codex, run /plugins, install nowledge-mem@nowledge-community, then retry."
} else {
  py -3 $HookSetup.FullName
}

[memories]
disable_on_external_context = true

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

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

nmem config mcp show --host codex

リポジトリレベルのインストール（代替）

共有マーケットプレイスソースの代わりに、ローカルCodexマーケットプレイスファイルを使用してプロジェクトリポジトリにプラグインをバンドルできます。 これにより、リポジトリをクローンした誰でもプラグインを利用できるようになります。

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
mkdir -p .agents
cp -r /tmp/nowledge-community/nowledge-mem-codex-plugin ./.agents/nowledge-mem
rm -rf /tmp/nowledge-community
mkdir -p .agents/plugins

.agents/plugins/marketplace.jsonを作成します：

{
  "name": "local",
  "plugins": [
    {
      "name": "nowledge-mem",
      "source": {
        "source": "local",
        "path": "./.agents/nowledge-mem"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}

pathはマーケットプレイスファイルではなく、リポジトリルートからの相対パスです。 このローカルセットアップでは、次を使用します：

[plugins."nowledge-mem@local"]
enabled = true

次に、リポジトリローカルのプラグインからフックセットアップを実行します：

python3 ./.agents/nowledge-mem/scripts/install_hooks.py

更新

0.1.14より前にCodexパッケージをインストールした場合は、まずマーケットプレイスを更新してください。 現在のCodexビルドは、すでにインストールされているパッケージキャッシュを再インストールせずにマーケットプレイスのチェックアウトを更新する場合があるため、パッケージ自体が更新されるまでフックセットアップファイルや同梱フックの変更がまだ欠けている可能性があります。

(codex plugin marketplace remove nowledge-community || codex marketplace remove nowledge-community || true)
codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin
codex plugin add nowledge-mem@nowledge-community

これは意図的にCodexスパースチェックアウトでマーケットプレイスを再追加します。 古いインストールではコミュニティリポジトリの完全クローンを使用していました。 Codexがgit clone marketplace source timed out after 30sまたはearly EOFを報告する場合、これが復旧パスです。 Codex /pluginsからnowledge-mem@nowledge-communityを更新または再インストールすることもできます。 パッケージ更新後にCodexを再起動します。

パッケージ自体が更新された後、フックランタイムを更新します：

HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
if [ -z "$HOOK_SETUP" ]; then
  echo "Hook setup is still missing. Reinstall nowledge-mem@nowledge-community from Codex /plugins, then retry."
else
  python3 "$HOOK_SETUP"
fi

マーケットプレイスがまだ登録されていない場合は、次を実行します：

codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin || codex marketplace add nowledge-co/community

次にCodexを再起動します。 リポジトリローカルの@localソースを使用している場合は、代わりにそのローカルソースパスを更新してください。

スキル

プラグインスキルはハイブリッドセットアップでも重要です。 これらはCodexにメモリをいつ使用するかを教え、MCPはCodexが行動を決定した後の低摩擦の実行パスを提供します。

Codex用Nowledge FS

Nowledge FSはKnowledge Treeの背後にある共有のパス優先レイヤーです。 これはCodex専用の機能ではありません。 CodexはMCPサーバーを通じて同じレイヤーをmem_fsで使用できます。 これはメモリ、スレッド、wikiページ、ワーキングメモリ、アクティビティ、ソース、アーティファクトにわたるパス優先ビューです。

mem_fs: recall "why did we change token refresh?" --in /memories -k 5
mem_fs: cat /memories/by-id/<id>.memory.md
mem_fs: ls /memories/by-label/auth

MCPが利用できない場合は、CLIを使用します：

nmem fs recall "session token strategy" --in /memories -k 5
nmem fs grep "JWT rotation" /memories
nmem fs cat /memories/by-id/<id>.memory.md

ファジーな意図にはrecall、メタデータ制約にはfind、正確な文字列にはgrep、大きな本文を読み込む前にstat、有用なパスが見つかった後にcatを使用します。 grepはデフォルトで大文字と小文字を区別しません。 正確な大文字と小文字には--case-sensitiveを、正規表現には-Eを追加します。 このプレビューリリースはAPIベースで、デスクトップ、Web、リモートセットアップで動作します。 実際のフォルダとしてマウントすることは後のフェーズで計画されています。

nmemの直接使用

nmemはユニバーサルフォールバックであり、実際のCodexスレッドインポートパスであり続けます。 Stopフックは同じコマンドを自動的に使用します：

nmem --json wm read
nmem --json m search "auth token rotation" --mode deep
nmem --json t save --from codex -p . -s "Finished the auth refactor."
nmem --json m add "JWT refresh failures came from clock skew." --title "JWT refresh failures traced to clock skew" --importance 0.9 --unit-type learning -l auth -s codex

デフォルトでは、nmem t save --from codexは~/.codexからセッションを読み取ります。 Codexホームが別の場所にある場合は、CODEX_HOMEを設定すると、保存パスが自動的に従います。

古いCodexセッションをインポートするには、まずプレビューします：

nmem t sync --from codex --all-projects --limit 20

次にインポートします：

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

1つのプロジェクトだけが必要な場合は、--all-projectsの代わりに-p /path/to/projectを使用します。 このコマンドはローカルCodexトランスクリプトファイルを読み取り、nmemで設定されたMemサーバーに書き込みます。

カスタムプロンプトからの移行

以前にnowledge-mem-codex-promptsを使用していた場合、プラグインはプロンプトが行っていたすべてをカバーします：

1. プラグインをインストールします（上記のセットアップを参照）。
2. 古いプロンプトを削除します：rm ~/.codex/prompts/{read_working_memory,search_memory,save_session,distill}.md
3. プラグインスキルがプロンプトを1対1で置き換えます。

トラブルシューティング

「Command not found: nmem」

pip install nmem-cliでインストールするか、uvx --from nmem-cli nmemを使用します。 Getting Startedを参照してください。

「Cannot connect to server」

nmem statusを実行し、リモートセットアップの場合はnmem config client showを実行します。 Remote Accessを参照してください。

スキルが表示されない

プラグインのインストール後にCodexを再起動します。 3つのことを確認します：マーケットプレイスが追加されたこと、nowledge-mem@nowledge-communityがcodex plugin addで、または/pluginsからインストールされたこと、~/.codex/config.tomlに[features] plugins = true、hooks = true、[plugins."nowledge-mem@nowledge-community"] enabled = trueがあること。 古いホストではplugin_hooks = trueも必要になる場合があります。 手動でフラグを追加するのではなく、セットアップを再実行してその要件を検出させてください。 意図的にリポジトリローカルソースを使用する場合は、[plugins."nowledge-mem@local"]を使用します。

Codexがunknown field description, expected hooksと言う

プラグインパッケージを0.1.19以降に更新し、Codexを再起動します：

(codex plugin marketplace remove nowledge-community || codex marketplace remove nowledge-community || true)
codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin
codex plugin add nowledge-mem@nowledge-community

この警告は、hooks/hooks.jsonの余分なメタデータを拒否する厳格なCodexフックパーサーから発生しました。 現在のパッケージはそのファイルをスキーマのみに保っています。

WSL内でCodexを使用する

Codexを実行するのと同じWSLディストリビューションからCodexプラグインをインストールおよび更新してください。 WindowsデスクトップアプリはWSL Codexプラグインが古いことを表示できますが、Windowsで更新を安全に実行することはできません。 それは間違ったシェル、プラグインキャッシュ、Python、~/.codexホームを使用することになるからです。 Memから更新コマンドをコピーし、WSL内で実行してから、そこでCodexを再起動します。

起動コンテキストまたはCodexスレッドが自動的に表示されない

フックセットアップを再度実行し、Codexを再起動します：

HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
test -n "$HOOK_SETUP" && python3 "$HOOK_SETUP"

セットアップは現在のフック機能を有効にし、まだそれを公開しているホストにのみレガシープラグインフックゲートを追加し、まだ~/.codex/hooks.jsonを必要とするCodexビルドのためにホストレベルのStopフォールバックを維持します。 /hooksを開き、Nowledge MemのSessionStart、UserPromptSubmit、Stopフックが両方とも有効で信頼されていることを確認します。 信頼は意図的にユーザーが所有するため、セットアップはそれをバイパスしません。

codex mcp listがNot logged inを表示する

nmemをMemアプリ/サーバーに一致するように更新し、ローカルデスクトップMemを使用する場合はデスクトップアプリからCLI設定をインストールしてから、フックセットアップを再実行します：

pip install -U nmem-cli
nmem status
HOOK_SETUP="$(find ~/.codex/plugins/cache -path '*/nowledge-mem/*/scripts/install_hooks.py' -print 2>/dev/null | sort | tail -1)"
test -n "$HOOK_SETUP" && python3 "$HOOK_SETUP"

codex mcp login nowledge-memを実行しないでください。 そのコマンドはOAuth MCPサーバー用です。 Nowledge Memはnmem config mcp show --host codexによって生成されたURLとヘッダーを使用します。

「plugin is not installed」

codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin（またはレガシーCodexではcodex marketplace add nowledge-co/community）を実行し、codex plugin add nowledge-mem@nowledge-communityで、または/pluginsからインストールしてから、~/.codex/config.tomlのプラグインキーを確認します。

Working Memoryを読み取るだけで、検索や蒸留をしない

パッケージを0.1.26以降に更新し、フックセットアップを再実行し、同梱のnowledge-mem MCPサーバーとUserPromptSubmitフックがCodexで表示されることを確認します。 CodexローカルMemoryが有効な場合は、Allow memory generation from tool-assisted tasksをオフにします。 より強力なリポジトリ固有の動作には、パッケージのAGENTS.mdをプロジェクトルートにマージします。 Memがリモートまたはデフォルトのローカルポートにない場合は、~/.codex/config.tomlにmcp_servers.nowledge-memを追加して同梱エンドポイントを上書きします。

関連

• コネクタの概要
• Nowledge FS
• Gemini CLI
• Claude Code
• リモートアクセス