Windows 向け Codex 用 AgentMemory

OpenAI Codex Desktop および Codex CLI 向けの、独立した Windows ネイティブの AgentMemory ダウンストリームです。

English | 한국어 | 日本語

[!IMPORTANT] これは独立したソースのみのテクニカルプレビューです。AgentMemory v0.9.29 に基づいていますが、公式のアップストリームリポジトリでも、@agentmemory/* の npm リリースでも、アップストリームのサポートの約束でもありません。ここで説明する Windows ビルドおよびインストーラの代わりに、アップストリームの npx コマンドや互換性プラグインマニフェストを使用しないでください。

開発メモ: このダウンストリームは AI 生成かつユーザーテスト済みです。完全な開示をお読みください。

このプレビューの機能

AgentMemory は、公式の AgentMemory メモリ、レッスン、グラフ、監査、および来歴ストアを唯一の正規ストアとして維持しながら、Codex タスク全体で有用なコンテキストを保持します。

• 4 つの管理された Codex フック (SessionStart、UserPromptSubmit、Stop、SessionEnd) を通じて、通常のメインエージェントのユーザープロンプトと最終的なアシスタント応答をキャプチャします。

• 周囲の UI、タイトル/フォークトラフィック、既知の内部ホストプロンプト、およびサブエージェントトラフィックを永続キャプチャから除外します。

• 書き込み、削除、キュレーション、および来歴を正確にプロジェクトスコープに限定します。

• ワイルドカード書き込みを許可せずに、プロジェクト間での境界付き、ソースラベル付きのフェデレーションリコールをサポートします。

• 型付きグラフ抽出のために、資格情報不要のループバック専用ローカル Qwen ワーカーを使用できます。他のすべての AgentMemory LLM 機能は noop プロバイダを受け取ります。外部フォールバックは無効のままです。

• Codex 用に認証付きループバック MCP エンドポイントを使用し、パッケージ化された stdio ランチャーは互換性パスのみとして保持します。

アップストリーム互換のソースサーフェスには 56 個の MCP ツールが含まれています。その MCP サーフェスは 56 ツール、6 リソース、3 プロンプトです。また、ポート 3111 に 133 エンドポイント、12 のポータブルフック、17 のスキルがあります。サポートされている Windows プロファイルは、上記の 4 つの管理フックのみを意図的にアクティブにします。

Related MCP server: remem

バージョン識別

正確なアップストリームタグ、コミット、ツリー、およびプリステインパッケージハッシュは、upstream-source.json に記録されています。

要件

• PowerShell 5.1 以降を搭載した Windows。このプレビューは Windows 11 で認定されています

• Node.js 20 以降

• リポジトリの固定パッケージマネージャ宣言による pnpm 11.19.0

• SHA-256 が packaging/windows-codex/config/third-party-inputs.json と一致する公式 iii エンジン 0.11.2 Windows 実行可能ファイル

最初のソースプレビューには、プリビルドまたは署名付きインストーラは添付されていません。

ソースからのビルドと評価

Windows でリポジトリをクローンし、PowerShell からリリースビルダーを実行します。出力ディレクトリは既に存在してはなりません。

git clone https://github.com/M-T-D-N/agentmemory-codex-windows.git
Set-Location agentmemory-codex-windows

& .\packaging\windows-codex\Build-WindowsCodex.ps1 `
  -OutputDirectory D:\staging\agentmemory-codex `
  -IiiEnginePath D:\inputs\iii-0.11.2.exe

通常のビルダーは、固定されたネイティブ入力を検証し、凍結されたロックを復元し、生成されたスキルをチェックし、型チェックを行い、ビルドし、パッケージおよび Codex アダプタテストを実行し、本番依存関係ツリーを作成し、完全な不変ファイルマニフェストを書き込みます。

インストーラはデフォルトでドライランです。何かを変更する前に、リリースハッシュ、所有権、パス、および既存のインストールを検証します。-Execute を使用する前に、packaging/windows-codex/README.md で正確なビルド、ドライラン、カットオーバー、ロールバック、保持、および認証契約を確認してください。

[!WARNING] Windows インストーラは、所有および管理された AgentMemoryCodex サービスレイアウト用に設計されています。無関係なディレクトリを指定したり、ビルド出力をユーザーデータとして扱ったりしないでください。正規の data、シークレット、ログ、タスク ID、およびロールバック状態は、独立したライフサイクルを持ちます。

プライバシーとセキュリティの境界

• MCP およびサービストラフィックは、サポートされているプロファイルでは認証付きループバックエンドポイントに留まります。

• オプションの Qwen プロバイダは、資格情報不要のループバック HTTP のみを受け入れ、グラフ抽出に機能が限定されています。

• ソースツリーには、メモリデータベース、セッショントランスクリプト、ユーザーエクスポート、API キー、生成されたインストーラ、またはプライベート開発履歴は含まれていません。

• セキュリティレポートは、GitHub のプライベート脆弱性報告フローを使用してください。SECURITY.md を参照してください。

リポジトリマップ

アップストリームのマーケティングウェブサイト、クラウドデプロイメント例、他のアップストリーム言語コピー、生成されたビルド出力、およびプライベートモノレポ履歴は、最初の公開リポジトリスナップショットの範囲外です。過去のベンチマーク資料は再現性のためだけに保持され、アップストリーム参照として明示的にラベル付けされています。これらのディレクトリのベンチマーク番号は、このダウンストリームプレビューの主張ではありません。

開発チェック

pnpm install --frozen-lockfile
pnpm run skills:check
pnpm run typecheck
pnpm run build
pnpm test
node packaging/windows-codex/tests/codex-turn.test.mjs

リポジトリは、アップストリームの @agentmemory/* パッケージ名での誤った公開を防ぐために、パッケージマニフェストで private とマークされています。貢献は CONTRIBUTING.md に従う必要があり、ダウンストリームのリリース履歴は CHANGELOG.md にあります。

AI 開発の開示

ダウンストリームの変更のほとんどは、ユーザー提供の要件と反復的な受け入れ要求から OpenAI Codex によって生成および改訂されました。リポジトリ所有者はソースコードを手動でレビューしていません。検証は、自動テストと、所有者の Windows/Codex 環境でのライブ機能テストに基づいています。独立した第三者によるコードまたはセキュリティ監査は実行されていません。

要するに: AI 生成、ユーザーテスト済み、手動コードレビューなし。

アップストリームの帰属とライセンス

このダウンストリームは、Rohit Ghumare および貢献者による AgentMemory に基づいています。帰属と正確なソース ID については、NOTICE および upstream-source.json を参照してください。コードは Apache License 2.0 の下で提供されています。