Codex Auxiliary Memory

A small, file-based supplementary memory package for Codex on Windows.

Long AI development sessions can lose important context during context compaction or session recovery. This package keeps selected supplementary memory in local files and reinjects a short, validated note at supported SessionStart boundaries (startup, resume, clear and post-compaction).

Start with your AI agent: give Codex the installation ZIP and the setup request below. Codex handles installation and verification; you review any required project/hook trust prompts. Targets Windows PowerShell 5.1 and a Codex client supporting project-local hooks.

Limits: only recorded, selected information can be reloaded. This is not automatic transcript saving, complete memory restoration or complete prevention of compaction loss. Actual hook delivery must be verified on your target client.

For development progress and machine-collected evidence, use the complementary DEV_STATE; neither tool grants execution permission.

It starts with empty memory: no author's profile, policy, host facts, conversation history, work state, decisions, credentials or trust settings.

Download and install

Download Codex-Auxiliary-Memory-v0.2.1.zip from GitHub Releases. GitHub's automatic Source code (zip) is the development source, not the ready-to-install package.

Give the installation ZIP to a new Codex chat and ask it to extract and set up:

Read FRESH_CHAT_HANDOFF.md and set this up for this project. Start with empty memory; do not import previous memory. Inspect existing hooks before installing. Handle installation and isolated tests, then report Status and target-client injection separately. Guide me only when trust approval requires my action.

See START_HERE.md for manual installation. Run the included tests before adapter Status, then verify actual session injection on your target. Project and hook trust must be reviewed in the target client when requested; the package does not copy trust or change global configuration.

What it does

Installation scope: PROJECT by default

Code/Hook location and data-sharing scope are different concepts. The standard installer places the Hook in <project>/.codex/ and memory in <project>/AI_MEMORY_BUNDLE/. Chats using that same project installation read the same selected memory. This keeps configuration bounded to the project; it does not provide private per-chat memory or automatically share across PCs/users.

Keep shared policies/facts separate from chat-specific task progress. In particular, state/current.md is also shared: it is not another chat's execution plan or GO. Use DEV_STATE's chat/session-owned state for development progress. Coordinate memory writes through one local writer; concurrent writers/cloud-sync safety is not guaranteed. Review who can read the local files before storing personal data.

GLOBAL/user-wide installation is not shipped. If requested, Codex must first assess feasibility, affected chats, data ownership, duplicate Hooks and verification, then confirm intent and approval for the nonstandard changes. Do not automatically overwrite, migrate or mix existing Hooks/settings/memory/progress/trust. Keep live memory, private configs and evidence out of Git/public uploads; have the agent inspect tracked files and establish appropriate exclusions. An ignore rule does not remove already-tracked data. Agent preflight: FRESH_CHAT_HANDOFF.md.

• Keeps small files for adopted policies, preferences, verified facts, current work, material decisions and unverified candidates.
• Validates a short derived HOT_STATE.md against the current-state hash.
• Uses a project-local SessionStart hook to reload that saved note at supported startup, resume, clear and post-compaction boundaries.
• Has no transcript processing, network dependency, per-turn model call, database or background service.

The adapter's normal HOT_STATE target is 4,096 UTF-8 bytes; larger notes are not injected as successful memory. Hooks validate and reload saved notes; they do not automatically record or summarize every conversation. AI must maintain relevant memory within the current user's authorized scope. Use “bootstrap supplementary memory” or “update supplementary memory” with Codex.

Boundaries and compatibility

• This is supplementary memory, not complete recall or a guarantee against forgetting.
• Stored notes and summaries cannot authorize work or override current instructions.
• Empty package memory does not clear Codex/ChatGPT native memory, personalization or project instructions.
• Targets Windows PowerShell 5.1 and a Codex client supporting the documented project-local hooks. Other platforms are not qualified by this release.
• Local fixture tests do not prove hook trust, actual startup delivery or actual post-compaction reinjection. Verify those separately in each target environment.
• Existing bundle/hook files are not overwritten. Inspect and merge separately.
• Never put credentials, secrets or full transcripts in memory.

Hook reference: official documentation. For safe removal see docs/UNINSTALL.md. Removal does not delete your memory.

Source and maintenance

package/ is the distribution source of truth. Do not maintain another hand-edited ZIP. Python 3.11 or newer, standard library only, is needed to build/test the release; it is not required for normal PowerShell adapter operation.

python tools/build_release.py
python tools/verify_release.py

The build regenerates hashes, audits empty memory and release contents, and creates the installation ZIP plus SHA256SUMS.txt under dist/. Verification installs only into a dedicated disposable fixture, runs the adapter tests and simulated lifecycle events, checks no-write/no-overwrite behavior, and removes only that fixture. It does not register or trust real hooks. An inherited PowerShell 7 module path is corrected only for child test processes.

License

MIT licensed.

---

Codex Auxiliary Memory — 日本語

Windows版Codex向けの、小さなファイルベースの補助記憶パッケージです。

長時間のAI開発セッションでは、コンテキスト圧縮やセッション再開により 重要な情報が失われることがあります。選択した補助記憶をローカルファイルに保持し、 対応するSessionStart境界（起動・再開・clear・圧縮後）で検証済みの短いメモを再投入します。

導入はAIへ依頼: Codexに導入用ZIPと 下記のセットアップ依頼を渡します。設置・検証はCodexが担当し、人間は必要な プロジェクト/Hookの信頼承認を行います。Windows PowerShell 5.1と、 プロジェクト内Hookに対応するCodexクライアントが対象です。

限界: 再投入できるのは選んで記録した情報だけです。会話全文の自動保存、完全な記憶復元、 圧縮による情報損失の完全防止ではありません。実Hook発火は導入先で確認が必要です。

開発進捗とマシンが取得した証拠には、相互補完する DEV_STATEを利用できます。どちらも実行許可を作りません。

記憶が空の状態から始めます。作者のプロフィール・ポリシー・PC情報・会話履歴・ 作業状態・決定履歴・資格情報・信頼設定は含みません。

ダウンロード・導入

GitHub Releasesから Codex-Auxiliary-Memory-v0.2.1.zipをダウンロードしてください。 GitHub標準の Source code (zip) は開発用ソースであり、導入用ZIPではありません。

導入用ZIPを新しいCodexチャットへ渡し、展開・セットアップを次のように依頼します。

FRESH_CHAT_HANDOFF.mdを読んで、このプロジェクトにセットアップして。 記憶は空から開始し、以前の記憶は取り込まないで。既存Hookは導入前に確認して。 設置と隔離試験を担当し、Statusと導入先の実注入結果は分けて報告して。 信頼承認で人間の操作が必要な場合だけ案内して。

手動導入はSTART_HERE.mdを参照してください。同梱テストを先に実行し、その後に アダプターのStatus、導入先の実セッションへの注入を確認します。 導入先でプロジェクトやHookの信頼確認が求められた場合は内容を確認してください。 信頼登録のコピーやグローバル設定の変更は行いません。

できること

導入スコープ：標準はPROJECT

機能の配置先とデータの共有範囲は別です。標準導入ではHookを <project>/.codex/、記憶を<project>/AI_MEMORY_BUNDLE/へ配置します。 同じ設置先を使う複数チャットは、選択した記憶を共有します。設定の影響をプロジェクト内に 限定する方式で、チャットごとの私有記憶や、複数PC・複数人の自動同期ではありません。

共有する方針・事実とチャット固有の進捗は区別してください。state/current.mdも共有なので、 別チャットの実行計画やGOとして採用しません。開発進捗はDEV_STATEのチャット/セッション別 状態へ記録します。記憶更新は単一のローカル書込み担当で調整し、同時書込みやクラウド同期の 安全性は保証しません。個人情報を記録する前にローカルファイルの閲覧範囲を確認します。

GLOBAL/ユーザー全体への導入機能は同梱していません。希望する場合、Codexが対応可否・ 影響するチャット・データ所有・Hook重複・検証方法を検討し、意図と非標準変更の承認範囲を 確認します。既存Hook・設定・記憶・進捗・信頼設定を自動で上書き・移行・混合しません。 実運用の記憶・固有設定・証拠をGitや公開物へ入れないよう、AIが追跡対象と除外設定を確認します。 ignoreだけでは既に追跡された情報は除去できません。AI向け事前確認はFRESH_CHAT_HANDOFF.md。

• 採用したポリシー・好み・確認済み事実・現在作業・重要な決定・未確認候補を小さなファイルで保持。
• 短い派生メモHOT_STATE.mdを現在状態のハッシュと照合。
• プロジェクト内のSessionStart Hookで、対応する起動・再開・clear・圧縮後に保存済みメモを読み戻す。
• 会話全文の処理・通信依存・毎ターンのモデル呼出し・DB・常駐サービスは不要。

HOT_STATEの通常目標はUTF-8で4,096バイトです。超過したメモを正常な記憶として 注入しません。Hookは保存済みメモを確認して読み戻すものであり、 会話をすべて自動記録・要約する機能ではありません。 AIが現在のユーザーの許可範囲内で必要な記録を維持します。 「補助記憶ブートして」「補助記憶に反映して」と依頼できます。

対応範囲・注意

• 完全な記憶や、忘れないことを保証する仕組みではありません。
• 保存メモ・要約は作業許可にならず、現在の指示を上書きしません。
• 空のパッケージでも、Codex/ChatGPT自身のMemory・個人設定・プロジェクト指示は消えません。
• Windows PowerShell 5.1と、記載のプロジェクトHookに対応したCodexクライアントが対象。 他OSは本版の検証対象外です。
• 隔離試験だけでは信頼登録・実起動時の注入・実圧縮後の再注入を証明できません。 導入先ごとに別途確認してください。
• 既存のバンドルやHookは上書きしません。統合は別途確認します。
• 資格情報・秘密情報・会話全文は保存しないでください。

Hookの参照：公式ドキュメント。 取り外し手順はdocs/UNINSTALL.mdを参照。取り外しても記憶は削除しません。

ソース・保守

配布内容の正本はpackage/です。ZIPを別途手修正して二重管理しません。 作成・検証にはPython 3.11以上の標準ライブラリのみを使用します。 通常のPowerShellアダプター運用にPythonは不要です。

python tools/build_release.py
python tools/verify_release.py

作成処理はハッシュを再生成し、初期記憶が空であることと配布内容を検査して、 dist/に導入用ZIPとSHA256SUMS.txtを生成します。 検証は専用の一時fixture内だけで導入・テスト・模擬ライフサイクル確認・ 無変更時の書込み禁止・既存対象の上書き禁止を確認し、fixtureだけを削除します。 実Hookの登録や信頼登録は行いません。 PowerShell 7由来のモジュールパスは試験の子プロセス内だけで補正します。

ライセンス

MITライセンスです。