What agents should know before contributing
openai/codex
Lightweight coding agent that runs in your terminal
Read by Bluet from 7 files written for agents and 300 merged pull requests on 2026-09-24. Not reviewed by the maintainers.
Rules its files tell agents (12)
- AGENTS.md
mustjust fix or just test) be patient with the command and never try to kill them using the PID.
When running Rust commands (e.g. just fix or just test) be patient with the command and never try to kill them using the PID. Rust lock can make the execution slow, this is expected.
- AGENTS.md
mustNever add or modify any code related to CODEX_SANDBOX_NETWORK_DISABLED_ENV_VAR or CODEX_SANDBOX_ENV_VAR.
- AGENTS.md
shouldDo not re-run tests after running fix or fmt.
Before finalizing a large change to codex-rs, run just fix -p <project> (in codex-rs directory) to fix any linter issues in the code. Prefer scoping with -p to avoid slow workspace‑wide Clippy builds; only run just fix without -p if you changed shared crates. Do not re-run tests after running fix or fmt.
- AGENTS.md
shouldDo not run cargo test directly.
Do not run cargo test directly. Use just test so test execution follows the repo defaults.
- AGENTS.md
shouldRun just fmt (in the codex-rs directory) automatically after you have finished making code changes anywhere in…
Run just fmt (in the codex-rs directory) automatically after you have finished making code changes anywhere in this repository; do not ask for approval to run it. Additionally, run the tests:
- AGENTS.md
shouldDo not create small helper methods that are referenced only once.
- AGENTS.md
shouldDo not call reset_client_session unnecessarily; let the incremental check logic decide whether to reuse the pr…
Do not call reset_client_session unnecessarily; let the incremental check logic decide whether to reuse the previous request.
- AGENTS.md
shouldDo not add general product or user-facing documentation to the docs/ folder.
Do not add general product or user-facing documentation to the docs/ folder. The official Codex documentation lives elsewhere. The exception is app-server API documentation, which is covered by the app-server guidance below.
- AGENTS.md
shouldDo not add negative tests for logic that was removed.
- AGENTS.md
shouldDo not add tests for values that are statically defined.
- AGENTS.md
shouldDo not use #[allow(async_fn_in_trait)] as a shortcut around spelling the future contract explicitly.
- AGENTS.md
shouldDo not add these comments for string or char literals unless the comment adds real clarity; those literals are…
Do not add these comments for string or char literals unless the comment adds real clarity; those literals are intentionally exempt from the lint.
Decisions its pull requests settled (1)
- #47340Add conditional turn interruption that preserves pending input