memories.md +10 −0
42thread has been idle long enough to avoid summarizing work that's still in42thread has been idle long enough to avoid summarizing work that's still in
43progress.43progress.
44 44
45Memory generation can also skip a background pass when your Codex rate-limit
46remaining percentage is below the configured threshold, so Codex doesn't spend
47quota when you're near a limit.
48
45## Memory storage49## Memory storage
46 50
47Codex stores memories under your Codex home directory. By default, that's51Codex stores memories under your Codex home directory. By default, that's
78 stored as memory-generation inputs.82 stored as memory-generation inputs.
79- `memories.use_memories`: controls whether Codex injects existing memories into83- `memories.use_memories`: controls whether Codex injects existing memories into
80 future sessions.84 future sessions.
85- `memories.disable_on_external_context`: when `true`, keeps threads that used
86 external context such as MCP tool calls, web search, or tool search out of
87 memory generation. The older `memories.no_memories_if_mcp_or_web_search` key
88 is still accepted as an alias.
89- `memories.min_rate_limit_remaining_percent`: controls the minimum remaining
90 Codex rate-limit percentage required before memory generation starts.
81- `memories.extract_model`: overrides the model used for per-thread memory91- `memories.extract_model`: overrides the model used for per-thread memory
82 extraction.92 extraction.
83- `memories.consolidation_model`: overrides the model used for global memory93- `memories.consolidation_model`: overrides the model used for global memory