CDX-201a · Module 1
Override Files & Local Customization
3 min read
AGENTS.override.md is a same-level file that takes priority over AGENTS.md at that directory. The primary use case: personal overrides that you do not want checked into version control. Add AGENTS.override.md to your .gitignore, and each developer can customize their Codex experience without affecting the team-shared configuration.
Common override patterns include personal model preferences (defaulting to a specific model), custom slash commands that only you use, debug-mode rules that relax constraints during development, and experimental features that are not ready for the team. The override file is also useful for temporary rules — "for this sprint, always include performance benchmarks in test output" — that you do not want permanently in the shared config.
# Personal Overrides (gitignored)
## Model Preferences
- Default to codex-1 for all tasks
- Use o3 with high reasoning for architecture discussions
## Debug Mode
- When I say "debug mode", add verbose logging to every function
- Include stack traces in error messages during development
## Personal Conventions
- I prefer explicit return types on all functions
- Always show the full file path in code comments
- Create the override Add AGENTS.override.md at the repo root with your personal preferences.
- Gitignore it Add `AGENTS.override.md` to .gitignore so personal rules stay local.
- Document the pattern Add a note in the team AGENTS.md: "Personal overrides go in AGENTS.override.md (gitignored)." This teaches new team members the convention.