AGENTS.mdExternal repository
OpenAI Codex repository instructions
A reviewed real-world AGENTS.md example from the official Codex repository, with scoped Rust, testing, API, and platform guidance.
- Revision
- 1
- Verified
- 2026-07-29
Compatibility and paths
Codex
AGENTS.mdRepository-root instructions with additional nested scope.Trust and provenance
Metadata reviewed 2026-07-29. OneLiners does not maintain or security-verify the linked files.
External repository
Open on GitHubopenai/codex
OneLiners reviewed the metadata and wrote this summary. The linked files remain maintained by their repository owner.
- Exact path
AGENTS.md- License
- Apache-2.0
- Reviewed commit
3725f02cf38d- Last checked
- 2026-07-29
Install and inspect
Dependencies
- Codex or another host that implements hierarchical AGENTS.md instructions.
- The repository-specific build, test, formatting, and review tools named in the instructions.
Install
- Read the pinned AGENTS.md as a real-world reference, not as a universal template.
- Extract only rules that match your repository, commands, architecture, and review policy.
- Save adapted project guidance as AGENTS.md and test its scope from relevant subdirectories.
Update
- Compare the complete pinned AGENTS.md diff before adapting rules from a newer Codex revision.
- Revalidate commands, protected paths, nested scope, and completion checks against the target repository.
When to use it
- Study how a large multi-language repository separates global rules from subsystem-specific guidance.
- Use the example to design concrete formatting, testing, dependency, and change-size rules for your own project.
Expected files
AGENTS.mdNested AGENTS.md files may add instructions for narrower repository paths.
Review boundaries
Required permissions
- Read access to repository instructions and the files in the active task scope.
- Commands and external writes remain subject to the host sandbox and user approval.
Security notes
- Do not copy repository-specific commands or protected-path rules into an unrelated project.
- The link is pinned for reviewability, but OneLiners does not maintain or security-audit the external instructions.
Real example
Input
Create repository instructions for a Rust workspace with integration tests and strict API compatibility.
Expected result
Use the pinned Codex AGENTS.md as a pattern, then write project-specific commands, scope, protected surfaces, and completion checks.