{"id":2950,"date":"2026-04-25T10:27:05","date_gmt":"2026-04-25T10:27:05","guid":{"rendered":"https:\/\/aiopsschool.com\/blog\/?p=2950"},"modified":"2026-04-25T10:41:05","modified_gmt":"2026-04-25T10:41:05","slug":"codex-save-context-memory-with-codex-a-complete-guide-codex-memories","status":"publish","type":"post","link":"https:\/\/aiopsschool.com\/blog\/codex-save-context-memory-with-codex-a-complete-guide-codex-memories\/","title":{"rendered":"Codex – Complete Guide to ~\/.codex\/memories\/: How to Save and Use Memory in Codex"},"content":{"rendered":"\n

<\/h1>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Codex can now remember useful context from earlier work and reuse it in future sessions. This guide explains what ~\/.codex\/memories\/<\/code> is, how to enable it, how to use it correctly, what to save, what not to save, and how to combine it with AGENTS.md<\/code> for a reliable long-term workflow.<\/p>\n\n\n\n

Codex Memories are currently off by default<\/strong>. When enabled, they help Codex remember stable preferences, workflows, tech stacks, project conventions, and known pitfalls across threads. OpenAI recommends treating memory as a helpful local recall layer, not as the only source of important rules. Required instructions should still live in AGENTS.md<\/code> or checked-in documentation. (OpenAI Developers<\/a>)<\/p>\n\n\n\n

\n\n\n\n

1. What is ~\/.codex\/memories\/<\/code>?<\/h2>\n\n\n\n

~\/.codex\/memories\/<\/code> is the local folder where Codex stores memory-related files.<\/p>\n\n\n\n

By default, Codex uses this home directory:<\/p>\n\n\n\n

~\/.codex\n<\/code><\/pre>\n\n\n\n
The main memory files live here:<\/p>\n\n\n\n
~\/.codex\/memories\/\n<\/code><\/pre>\n\n\n\n
These files can include summaries, durable memory entries, recent inputs, and supporting evidence from prior Codex threads. OpenAI describes these files as generated state: you can inspect them, especially for troubleshooting, but you should not treat manual editing as the main way to control Codex behavior. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
2. What problem does Codex Memory solve?<\/h2>\n\n\n\n
Without memory, you may need to repeat the same context every time:<\/p>\n\n\n\n
This is a Laravel project.\nUse Pest for tests.\nDo not edit generated files.\nAlways check routes first.\nPrefer small commits.\nDo not touch payment logic without asking.\n<\/code><\/pre>\n\n\n\n
With memory enabled, Codex can gradually learn stable working context from previous sessions, so future sessions can start with better background knowledge. It is useful for recurring preferences, coding style, common project structure, repeated debugging patterns, and known mistakes to avoid. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
3. Memory is not the same as AGENTS.md<\/code><\/h2>\n\n\n\n
This is the most important concept.<\/p>\n\n\n\n
Use Codex Memory<\/strong> for:<\/p>\n\n\n\n
Useful background Codex can remember from previous work.\n<\/code><\/pre>\n\n\n\n
Use AGENTS.md<\/strong> for:<\/p>\n\n\n\n
Rules Codex must reliably follow every time.\n<\/code><\/pre>\n\n\n\n
For example, this belongs in memory:<\/p>\n\n\n\n
The developer usually prefers small, targeted pull requests.\n<\/code><\/pre>\n\n\n\n
This belongs in AGENTS.md<\/code>:<\/p>\n\n\n\n
Never commit secrets.\nAlways run tests before finishing.\nDo not modify generated files.\n<\/code><\/pre>\n\n\n\n
Codex reads AGENTS.md<\/code> before doing work, and OpenAI recommends using it for reusable repository guidance such as repo layout, test commands, conventions, constraints, and verification steps. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
4. Where is ~\/.codex\/memories\/<\/code> located?<\/h2>\n\n\n\n
On Linux or macOS:<\/p>\n\n\n\n
~\/.codex\/memories\/\n<\/code><\/pre>\n\n\n\n
On a Linux server, ~<\/code> depends on the current user.<\/p>\n\n\n\n
For a normal user:<\/p>\n\n\n\n
\/home\/username\/.codex\/memories\/\n<\/code><\/pre>\n\n\n\n
For root:<\/p>\n\n\n\n
\/root\/.codex\/memories\/\n<\/code><\/pre>\n\n\n\n
Check your actual home directory:<\/p>\n\n\n\n
echo ~\n<\/code><\/pre>\n\n\n\n
Then check the Codex folder:<\/p>\n\n\n\n
ls -la ~\/.codex\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
5. Enable Codex Memories<\/h2>\n\n\n\n
Create the Codex config directory:<\/p>\n\n\n\n
mkdir -p ~\/.codex\n<\/code><\/pre>\n\n\n\n
Open the config file:<\/p>\n\n\n\n
nano ~\/.codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Add:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
Save the file.<\/p>\n\n\n\n
Codex user-level configuration lives in ~\/.codex\/config.toml<\/code>, and project-level overrides can live in .codex\/config.toml<\/code> inside a repository. Codex loads configuration from multiple layers, with CLI overrides taking highest priority, followed by profiles, trusted project config, user config, system config, and built-in defaults. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
6. Avoid duplicate [features]<\/code> blocks<\/h2>\n\n\n\n
Before adding anything, inspect your config:<\/p>\n\n\n\n
cat ~\/.codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Bad example:<\/p>\n\n\n\n
[features]\nmemories = true<\/code><\/pre>\n\n\n
[features]<\/p>\n\n\n\n
codex_hooks = true<\/p>\n\n\n\n
Good example:<\/p>\n\n\n\n
[features]\nmemories = true\ncodex_hooks = true\n<\/code><\/pre>\n\n\n\n
A TOML config should not have repeated identical table headers unless the format explicitly expects arrays of tables. For normal Codex feature flags, keep all feature flags under one [features]<\/code> section.<\/p>\n\n\n\n
\n\n\n\n
7. Confirm the memory folder<\/h2>\n\n\n\n
After enabling memory, run:<\/p>\n\n\n\n
ls -la ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
If it does not exist yet, that can be normal.<\/p>\n\n\n\n
Codex does not necessarily create memory files immediately. It can skip active or short-lived sessions, redact secrets from generated memory fields, and update memories later instead of immediately when a thread ends. Memories may not update until a thread has been idle long enough. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
You can also check:<\/p>\n\n\n\n
find ~\/.codex -maxdepth 3 -type d -print\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
8. Basic memory workflow<\/h2>\n\n\n\n
A simple workflow looks like this:<\/p>\n\n\n\n
1. Enable memories in ~\/.codex\/config.toml\n2. Use Codex normally\n3. Give Codex stable context during real work\n4. Let Codex generate memory over time\n5. Keep hard rules in AGENTS.md\n6. Review memory files when troubleshooting\n<\/code><\/pre>\n\n\n\n
Example first memory-seeding prompt:<\/p>\n\n\n\n
Remember this for future Codex work:\n\nI usually prefer small, targeted changes.\nBefore editing, inspect only the files relevant to the task.\nDo not refactor unrelated code.\nWhen a task is ambiguous, make a short plan first.\nWhen changing code, explain what changed and how to test it.\n<\/code><\/pre>\n\n\n\n
This kind of prompt gives Codex reusable context without locking critical rules only inside memory.<\/p>\n\n\n\n
\n\n\n\n
9. What should you save in Codex Memory?<\/h2>\n\n\n\n
Good memory candidates are durable, reusable, and not secret.<\/p>\n\n\n\n
Examples:<\/p>\n\n\n\n
The user prefers small, focused changes.\nThe user prefers minimal dependencies.\nThe main backend is Laravel.\nThe frontend uses React and Tailwind.\nTests should be run with npm test.\nThe project uses PostgreSQL locally.\nThe team prefers conventional commits.\nThe user likes short explanations after code changes.\nThe codebase has legacy modules that should not be refactored casually.\n<\/code><\/pre>\n\n\n\n
These are useful because they apply across multiple future sessions.<\/p>\n\n\n\n
\n\n\n\n
10. What should not go into Codex Memory?<\/h2>\n\n\n\n
Do not intentionally store secrets or sensitive operational data.<\/p>\n\n\n\n
Avoid saving:<\/p>\n\n\n\n
API keys\nDatabase passwords\nSSH private keys\nProduction tokens\nOAuth secrets\nCustomer data\nPrivate financial data\nCredentials from .env files\nOne-time incident details\nTemporary debugging output\n<\/code><\/pre>\n\n\n\n
OpenAI says Codex redacts secrets from generated memory fields, but you should still avoid storing secrets and review memory files before sharing your Codex home directory or generated memory artifacts. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
11. How to use \/memories<\/code> inside Codex<\/h2>\n\n\n\n
Inside the Codex app or TUI, use:<\/p>\n\n\n\n
\/memories\n<\/code><\/pre>\n\n\n\n
This lets you control memory behavior for the current thread.<\/p>\n\n\n\n
You can decide whether the current thread can:<\/p>\n\n\n\n
Use existing memories\nGenerate future memories\n<\/code><\/pre>\n\n\n\n
Thread-level choices do not change your global memory settings. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
Use this when you are working on sensitive or temporary tasks.<\/p>\n\n\n\n
\n\n\n\n
12. Recommended beginner config<\/h2>\n\n\n\n
For most users:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
That is enough to start.<\/p>\n\n\n\n
Then use Codex normally and let memories build over time.<\/p>\n\n\n\n
\n\n\n\n
13. Recommended practical config<\/h2>\n\n\n\n
For users who want memory but want to avoid saving externally sourced or tool-heavy threads:<\/p>\n\n\n\n
[features]\nmemories = true<\/code><\/pre>\n\n\n
[memories]<\/p>\n\n\n\n
use_memories = true generate_memories = true disable_on_external_context = true min_rollout_idle_hours = 6 max_rollout_age_days = 30 max_unused_days = 30<\/p>\n\n\n\n
Meaning:<\/p>\n\n\n\n
use_memories = true\n<\/code><\/pre>\n\n\n\n
Codex can inject existing memories into future sessions.<\/p>\n\n\n\n
generate_memories = true\n<\/code><\/pre>\n\n\n\n
New threads can become memory-generation inputs.<\/p>\n\n\n\n
disable_on_external_context = true\n<\/code><\/pre>\n\n\n\n
Threads that used external context such as MCP tool calls, web search, or tool search are excluded from memory generation.<\/p>\n\n\n\n
min_rollout_idle_hours = 6\n<\/code><\/pre>\n\n\n\n
Codex waits before considering a thread for memory generation.<\/p>\n\n\n\n
max_rollout_age_days = 30\n<\/code><\/pre>\n\n\n\n
Codex only considers recent threads up to the configured age.<\/p>\n\n\n\n
The official config reference documents these memory settings, including generate_memories<\/code>, use_memories<\/code>, disable_on_external_context<\/code>, max_rollout_age_days<\/code>, max_unused_days<\/code>, and min_rollout_idle_hours<\/code>. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
14. Advanced memory settings explained<\/h2>\n\n\n\n
memories.use_memories<\/code><\/h3>\n\n\n\n
[memories]\nuse_memories = true\n<\/code><\/pre>\n\n\n\n
When true, Codex can use existing memories in future sessions.<\/p>\n\n\n\n
To temporarily stop Codex from using existing memories:<\/p>\n\n\n\n
[memories]\nuse_memories = false\n<\/code><\/pre>\n\n\n\n
When false, Codex skips injecting existing memories into future sessions. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
memories.generate_memories<\/code><\/h3>\n\n\n\n
[memories]\ngenerate_memories = true\n<\/code><\/pre>\n\n\n\n
When true, Codex can use newly created threads as inputs for future memory generation.<\/p>\n\n\n\n
To stop creating new memories:<\/p>\n\n\n\n
[memories]\ngenerate_memories = false\n<\/code><\/pre>\n\n\n\n
When false, newly created threads are not stored as memory-generation inputs. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
memories.disable_on_external_context<\/code><\/h3>\n\n\n\n
[memories]\ndisable_on_external_context = true\n<\/code><\/pre>\n\n\n\n
This is useful when you use MCP tools, web search, or other external context and do not want those threads used for memory generation. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
memories.min_rollout_idle_hours<\/code><\/h3>\n\n\n\n
[memories]\nmin_rollout_idle_hours = 6\n<\/code><\/pre>\n\n\n\n
This controls how long a thread must be idle before Codex considers it for memory generation. The documented default is 6 hours, with a clamped range of 1 to 48 hours. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
memories.max_rollout_age_days<\/code><\/h3>\n\n\n\n
[memories]\nmax_rollout_age_days = 30\n<\/code><\/pre>\n\n\n\n
This controls the maximum age of threads considered for memory generation. The documented default is 30 days, with a clamped range of 0 to 90 days. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
memories.max_unused_days<\/code><\/h3>\n\n\n\n
[memories]\nmax_unused_days = 30\n<\/code><\/pre>\n\n\n\n
This controls how long an unused memory remains eligible for consolidation. The documented default is 30 days, with a clamped range of 0 to 365 days. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
15. How to inspect memories<\/h2>\n\n\n\n
List memory files:<\/p>\n\n\n\n
ls -la ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
Find files:<\/p>\n\n\n\n
find ~\/.codex\/memories -maxdepth 3 -type f -print\n<\/code><\/pre>\n\n\n\n
Preview safely:<\/p>\n\n\n\n
find ~\/.codex\/memories -maxdepth 3 -type f -print -exec sed -n '1,80p' {} \\;\n<\/code><\/pre>\n\n\n\n
Check folder size:<\/p>\n\n\n\n
du -sh ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
Search for a keyword:<\/p>\n\n\n\n
grep -R \"Laravel\" ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
Search for possible secrets before sharing:<\/p>\n\n\n\n
grep -R -i \"password\\|secret\\|token\\|api_key\\|apikey\\|private key\" ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
16. How to delete memories<\/h2>\n\n\n\n
Delete all memories:<\/p>\n\n\n\n
rm -rf ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
Recreate the folder:<\/p>\n\n\n\n
mkdir -p ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
This deletes existing memory files, but it does not necessarily disable memory. If this remains enabled:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
Codex may create new memories later.<\/p>\n\n\n\n
\n\n\n\n
17. How to disable memory completely<\/h2>\n\n\n\n
Edit:<\/p>\n\n\n\n
nano ~\/.codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Set:<\/p>\n\n\n\n
[features]\nmemories = false<\/code><\/pre>\n\n\n
[memories]<\/p>\n\n\n\n
use_memories = false generate_memories = false<\/p>\n\n\n\n
Then remove existing memory files if desired:<\/p>\n\n\n\n
rm -rf ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
18. How to pause memory for sensitive work<\/h2>\n\n\n\n
Inside Codex:<\/p>\n\n\n\n
\/memories\n<\/code><\/pre>\n\n\n\n
Disable memory generation for that thread.<\/p>\n\n\n\n
Use this for:<\/p>\n\n\n\n
Production debugging\nSecret rotation\nSecurity incidents\nCustomer-specific debugging\n.env inspection\nDatabase credential work\nPayment provider debugging\nPrivate logs\n<\/code><\/pre>\n\n\n\n
You can also make your config stricter:<\/p>\n\n\n\n
[features]\nmemories = true<\/code><\/pre>\n\n\n
[memories]<\/p>\n\n\n\n
use_memories = true generate_memories = true disable_on_external_context = true<\/p>\n\n\n\n
\n\n\n\n
19. Combine memory with AGENTS.md<\/code><\/h2>\n\n\n\n
A strong setup uses both.<\/p>\n\n\n\n
Create global instructions:<\/p>\n\n\n\n
mkdir -p ~\/.codex\n\ncat > ~\/.codex\/AGENTS.md <<'EOF'\n# Global Codex working rules\n\n- Prefer small, focused changes.\n- Explain what files you changed and why.\n- Do not edit unrelated files.\n- Do not expose secrets.\n- Ask before adding new production dependencies.\n- Run relevant tests when possible.\n- If a task is complex, make a short plan before editing.\nEOF\n<\/code><\/pre>\n\n\n\n
Codex reads global guidance from the Codex home directory, usually ~\/.codex<\/code>, and also reads project-level AGENTS.md<\/code> files when present. More specific files closer to the working directory override earlier guidance because they appear later in the combined prompt. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
20. Create project-specific AGENTS.md<\/code><\/h2>\n\n\n\n
Inside a repo:<\/p>\n\n\n\n
cat > AGENTS.md <<'EOF'\n# Project instructions\n\n## Project layout\n- app\/ contains application code\n- tests\/ contains automated tests\n- docs\/ contains documentation\n\n## Commands\n- Run tests with: npm test\n- Run lint with: npm run lint\n- Run build with: npm run build\n\n## Rules\n- Do not edit generated files.\n- Do not change public APIs without explaining the impact.\n- Keep changes small and reviewable.\n- Update tests when behavior changes.\n\n## Done means\n- Relevant tests pass.\n- No unrelated files are changed.\n- The final response explains what changed and how to verify it.\nEOF\n<\/code><\/pre>\n\n\n\n
This is better than relying only on memory because AGENTS.md<\/code> is explicit, reviewable, shareable with a team, and automatically loaded as project guidance. OpenAI\u2019s best-practices guide describes AGENTS.md<\/code> as the best place to encode how a team wants Codex to work in a repository. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
21. How to seed memory properly<\/h2>\n\n\n\n
Do not just say:<\/p>\n\n\n\n
Remember my project.\n<\/code><\/pre>\n\n\n\n
That is too vague.<\/p>\n\n\n\n
Use structured context:<\/p>\n\n\n\n
Remember this for future Codex sessions:\n\nMy coding preferences:\n- Prefer small, targeted changes.\n- Do not refactor unrelated code.\n- Explain assumptions before editing.\n- Prefer existing project conventions over introducing new patterns.\n\nMy review preferences:\n- Summarize changed files.\n- Mention tests run.\n- Mention any risks or follow-up work.\n\nMy safety preferences:\n- Never print secrets.\n- Avoid reading .env unless explicitly necessary.\n- Ask before adding production dependencies.\n<\/code><\/pre>\n\n\n\n
This gives Codex stable, reusable information.<\/p>\n\n\n\n
\n\n\n\n
22. Good memory prompts<\/h2>\n\n\n\n
For personal coding style<\/h3>\n\n\n\n
Remember for future Codex work:\nI prefer minimal, focused patches. Avoid broad refactors unless I explicitly ask for them. When making changes, explain the exact files changed and the test command to run.\n<\/code><\/pre>\n\n\n\n
For a tech stack<\/h3>\n\n\n\n
Remember for future Codex work:\nMost of my backend projects use Laravel, MySQL, and Blade. When debugging Laravel, check routes, controllers, models, migrations, middleware, config, and logs only as needed.\n<\/code><\/pre>\n\n\n\n
For frontend preferences<\/h3>\n\n\n\n
Remember for future Codex work:\nFor frontend work, I prefer React with Tailwind, simple components, accessible markup, and minimal new dependencies.\n<\/code><\/pre>\n\n\n\n
For review behavior<\/h3>\n\n\n\n
Remember for future Codex work:\nWhen reviewing code, focus on correctness, security, edge cases, performance, and maintainability. Give actionable fixes, not only comments.\n<\/code><\/pre>\n\n\n\n
For cost control<\/h3>\n\n\n\n
Remember for future Codex work:\nBefore scanning a large repository, identify the most likely files first. Avoid reading vendor, node_modules, build output, cache directories, logs, and generated files unless explicitly needed.\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
23. Bad memory prompts<\/h2>\n\n\n\n
Avoid vague prompts:<\/p>\n\n\n\n
Remember everything about this repo.\n<\/code><\/pre>\n\n\n\n
Avoid secrets:<\/p>\n\n\n\n
Remember my production database password is ...\n<\/code><\/pre>\n\n\n\n
Avoid temporary facts:<\/p>\n\n\n\n
Remember I am debugging this issue today at 3 PM.\n<\/code><\/pre>\n\n\n\n
Avoid unstable assumptions:<\/p>\n\n\n\n
Remember this API is always broken.\n<\/code><\/pre>\n\n\n\n
Better:<\/p>\n\n\n\n
Remember that this codebase has had recurring issues around API timeout handling. When debugging API failures, check retry logic, timeout configuration, and error logging.\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
24. Memory workflow for large codebases<\/h2>\n\n\n\n
For a large codebase, memory should help Codex avoid rediscovering the same structure every time.<\/p>\n\n\n\n
Example memory prompt:<\/p>\n\n\n\n
Remember this large-repo workflow:\n\n1. First identify the relevant module.\n2. Avoid scanning the whole repository.\n3. Check README, AGENTS.md, routes, entry points, and tests first.\n4. Ignore dependencies, generated files, build output, logs, and cache directories.\n5. Before editing, state the small set of files to inspect.\n6. Make the smallest safe change.\n<\/code><\/pre>\n\n\n\n
Then encode hard rules in AGENTS.md<\/code>.<\/p>\n\n\n\n
\n\n\n\n
25. Memory workflow for teams<\/h2>\n\n\n\n
For teams, do not depend on one developer\u2019s local memory.<\/p>\n\n\n\n
Use this pattern:<\/p>\n\n\n\n
Team-wide required behavior \u2192 AGENTS.md\nPersonal preferences \u2192 ~\/.codex\/AGENTS.md\nHelpful previous context \u2192 ~\/.codex\/memories\/\nTemporary task details \u2192 current prompt\n<\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
~\/.codex\/AGENTS.md\n<\/code><\/pre>\n\n\n\n
Personal preferences.<\/p>\n\n\n\n
project\/AGENTS.md\n<\/code><\/pre>\n\n\n\n
Team and repository rules.<\/p>\n\n\n\n
~\/.codex\/memories\/\n<\/code><\/pre>\n\n\n\n
Generated recall from prior work.<\/p>\n\n\n\n
Current prompt\n<\/code><\/pre>\n\n\n\n
Task-specific instructions.<\/p>\n\n\n\n
This keeps the workflow reliable and shareable.<\/p>\n\n\n\n
\n\n\n\n
26. Memory and config precedence<\/h2>\n\n\n\n
Codex config can come from several places. In general, one-off CLI flags and --config<\/code> overrides take priority over profiles, then project config, then user config, then system config, then defaults. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
This matters because memory might be enabled globally but disabled for one run:<\/p>\n\n\n\n
codex -c features.memories=false\n<\/code><\/pre>\n\n\n\n
Or memory might be enabled globally but overridden by a profile.<\/p>\n\n\n\n
\n\n\n\n
27. Project-level memory behavior<\/h2>\n\n\n\n
You can keep general memory enabled globally:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
Then control project behavior using project config:<\/p>\n\n\n\n
mkdir -p .codex\nnano .codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Example:<\/p>\n\n\n\n
[memories]\ngenerate_memories = false\n<\/code><\/pre>\n\n\n\n
This is useful for sensitive repositories.<\/p>\n\n\n\n
Project-scoped .codex\/config.toml<\/code> files are loaded only for trusted projects. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
28. Advanced: reduce accidental parent-folder context<\/h2>\n\n\n\n
For large workspaces or monorepos, configure project root markers carefully.<\/p>\n\n\n\n
Codex discovers project configuration by walking up from the working directory until it reaches a project root. By default, a directory containing .git<\/code> is treated as a project root. You can customize this with project_root_markers<\/code>. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
Example:<\/p>\n\n\n\n
project_root_markers = [\".git\", \"composer.json\", \"package.json\"]\n<\/code><\/pre>\n\n\n\n
Or force Codex to treat only the current directory as the root:<\/p>\n\n\n\n
project_root_markers = []\n<\/code><\/pre>\n\n\n\n
This can help prevent Codex from accidentally loading broader parent-level context in unusual folder structures.<\/p>\n\n\n\n
\n\n\n\n
29. Troubleshooting<\/h2>\n\n\n\n
Problem: ~\/.codex\/memories\/<\/code> does not exist<\/h3>\n\n\n\n
Check config:<\/p>\n\n\n\n
cat ~\/.codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Confirm:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
Then use Codex normally. The folder may appear later.<\/p>\n\n\n\n
\n\n\n\n
Problem: memory folder exists but is empty<\/h3>\n\n\n\n
This can happen when:<\/p>\n\n\n\n
Memories were just enabled.\nThreads were too short.\nThreads are still active.\nIdle time has not passed.\nMemory generation is disabled.\nThe current region\/account does not support memories.\n<\/code><\/pre>\n\n\n\n
Codex may wait before creating memory because it avoids summarizing work that may still be in progress. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
Problem: Codex remembers wrong information<\/h3>\n\n\n\n
Correct it in the next session:<\/p>\n\n\n\n
The previous memory is outdated. Update your understanding:\nThis project now uses PostgreSQL, not MySQL.\nUse pnpm, not npm.\nRun tests with pnpm test.\n<\/code><\/pre>\n\n\n\n
Then add hard rules to AGENTS.md<\/code>.<\/p>\n\n\n\n
If needed, delete memory files:<\/p>\n\n\n\n
rm -rf ~\/.codex\/memories\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Problem: Codex ignores memory<\/h3>\n\n\n\n
Check whether memory usage is disabled:<\/p>\n\n\n\n
grep -n \"use_memories\\|generate_memories\\|memories\" ~\/.codex\/config.toml\n<\/code><\/pre>\n\n\n\n
Look for:<\/p>\n\n\n\n
[memories]\nuse_memories = false\n<\/code><\/pre>\n\n\n\n
Set it back to:<\/p>\n\n\n\n
[memories]\nuse_memories = true\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Problem: You want memory only sometimes<\/h3>\n\n\n\n
Keep global memory enabled:<\/p>\n\n\n\n
[features]\nmemories = true\n<\/code><\/pre>\n\n\n\n
Use \/memories<\/code> inside Codex to disable memory for specific sensitive threads. (OpenAI Developers<\/a>)<\/p>\n\n\n\n
\n\n\n\n
30. Recommended final setup<\/h2>\n\n\n\n
For most developers:<\/p>\n\n\n\n
# ~\/.codex\/config.toml<\/code><\/pre>\n\n\n
[features]<\/p>\n\n\n\n
memories = true<\/p>\n\n\n
[memories]<\/p>\n\n\n\n
use_memories = true generate_memories = true disable_on_external_context = true min_rollout_idle_hours = 6 max_rollout_age_days = 30 max_unused_days = 30<\/p>\n\n\n\n
Create global instructions:<\/p>\n\n\n\n
mkdir -p ~\/.codex\n\ncat > ~\/.codex\/AGENTS.md <<'EOF'\n# Global Codex instructions\n\n- Prefer small, focused changes.\n- Do not refactor unrelated code.\n- Do not expose secrets.\n- Ask before adding major dependencies.\n- Explain changed files and verification steps.\n- Use the project\u2019s existing conventions.\nEOF\n<\/code><\/pre>\n\n\n\n
Inside each serious project, create:<\/p>\n\n\n\n
AGENTS.md\n<\/code><\/pre>\n\n\n\n
with project-specific rules.<\/p>\n\n\n\n
\n\n\n\n
Final mental model<\/h1>\n\n\n\n
Think of Codex context like this:<\/p>\n\n\n\n
Current prompt\n= what you want now\n\nAGENTS.md\n= rules Codex should reliably follow\n\n~\/.codex\/config.toml\n= how Codex should behave\n\n~\/.codex\/memories\/\n= useful context Codex learned over time\n<\/code><\/pre>\n\n\n\n
Memory is powerful, but it should not be your only control system. Use it to reduce repetition. Use AGENTS.md<\/code> for rules. Use config.toml<\/code> for behavior. Use clear prompts for the task at hand.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Codex can now remember useful context from earlier work and reuse it in future sessions. This guide explains what ~\/.codex\/memories\/ […]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2950","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/2950","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=2950"}],"version-history":[{"count":4,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/2950\/revisions"}],"predecessor-version":[{"id":2957,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/2950\/revisions\/2957"}],"wp:attachment":[{"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=2950"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=2950"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aiopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=2950"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}