Skip to content

OpenAI's Codex Security CLI and TypeScript SDK for finding, validating, and fixing security vulnerabilities. npm: https://www.npmjs.com/package/@openai/codex-security

docs: require explicit requests for public CLI changes (#579)

mldangelo-oai54b547742aba
diff --git a/AGENTS.md b/AGENTS.md
index e21938d64..ca4f5c946 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,21 @@ Codex Security is a thin wrapper around Codex and its security plugin.
only after checking that it is public. If you cannot confirm its visibility,
leave it out.
+## Public CLI changes
+
+Treat commands, arguments, flags, accepted values, public environment
+variables, and defaults as public API.
+
+- Do not add or change public CLI surface unless the task explicitly calls for
+ it. A request for new behavior is not permission to invent a command or flag.
+- Prefer existing commands, settings, and Codex behavior. Do not add flags for
+ implementation convenience or when a safe, compatible default is enough.
+- Before adding CLI surface, explain the user need, exact syntax and defaults,
+ why existing behavior is insufficient, and compatibility impact. Ask if those
+ choices are unclear.
+- Update relevant help, schemas, documentation, and tests in the same change.
+ Describe the public CLI change in the pull request.
+
## Public repository and pull requests
Everything published in this repository is public. Review branch names before