Memories

概要

以前の作業から有用なコンテキストを次の作業へ引き継ぐ仕組み。ローカルの Codex memories は既定で off で、config.toml の [features] memories は Experimental とされている。ChatGPT web は ChatGPT memory を使い、ローカルの Codex クライアントは別のローカルメモリストアと制御を使う。

仕様

サーフェスごとの違い

サーフェス	挙動
ChatGPT desktop app	`/memories` で、そのチャットがローカルメモリを使えるか／将来のメモリに寄与するかを選ぶ。オン・オフは Settings > Personalization
ChatGPT Work（web）	Settings > Personalization で ChatGPT memory を管理する。アカウントとワークスペースで使える memory 設定を使い、ローカルの Codex memory ストアやローカルの memory コントロールは使わない
Codex CLI	対話セッションで `/memories`。コマンドが無い場合はローカル memories の設定が必要
IDE extension	接続先の Codex host のローカルメモリストアを使う。その host で memories が有効なとき、Codex CLI と同じチャットレベルの操作ができる

ChatGPT desktop app には、画面から直近の作業コンテキストを回収してメモリを積み上げる Chronicle というデスクトップ専用機能がある

動作

有効にすると、対象となる過去のチャットから有用なコンテキストをローカルのメモリファイルにする
アクティブなセッションと短命なセッションはスキップする
生成されるメモリフィールドから秘密情報を redact する
更新は各チャットの終了直後ではなくバックグラウンドで行われる。進行中の作業を要約しないよう、チャットが十分アイドルになるまで待つ
Codex の rate-limit の残り割合が設定した閾値を下回っている場合、バックグラウンドのメモリ生成パスをスキップする

保存場所

Codex home（既定 ~/.codex）配下に保存される
主なメモリファイルは ~/.codex/memories/ にあり、要約、恒久的なエントリ、直近の入力、過去のチャットからの裏付けを含む
これらは生成された状態として扱う。 トラブルシュートや Codex home を共有する前の確認には見てよいが、主要な制御手段として手で編集することは想定されていない

チャット単位の制御

ChatGPT desktop app と Codex TUI では /memories で現在のチャットの挙動を制御する
既存メモリを使うか、そのチャットを将来のメモリ生成に使うかを選べる
チャットレベルの選択はグローバルの memory 設定を変えない

有効化

ChatGPT desktop app では Settings > Personalization の Enable memories
config では config.toml に feature flag を追加する

主なメモリ関連設定:

memories.generate_memories: 新規チャットをメモリ生成の入力として保存できるか
memories.use_memories: 既存メモリを以後のセッションに注入するか
memories.disable_on_external_context: true で、MCP ツール呼び出し・web search・tool search など外部コンテキストを使ったチャットをメモリ生成から外す。旧キー memories.no_memories_if_mcp_or_web_search もエイリアスとして受け付けられる
memories.min_rate_limit_remaining_percent: メモリ生成を始めるのに必要な rate-limit の残り割合の下限
memories.extract_model: チャット単位のメモリ抽出に使うモデルの上書き
memories.consolidation_model: グローバル統合に使うモデルの上書き

各設定の既定値と clamp の範囲は facts/codex/configuration-reference.md を参照。

設定

[features]
memories = true

制約・注意点

必ず適用されるべきチームの指針は AGENTS.md やリポジトリに入れたドキュメントに置く。 memories は補助的な想起層であり、常に効くルールの唯一の置き場所にはしない
メモリに秘密情報を入れない。Codex は生成されたメモリフィールドから秘密情報を redact するが、Codex home や生成物を共有する前にメモリファイルを確認する