Codex CLI
Announcement: Begin with: "I'm using the codex-cli skill for cross-AI validation with Codex."
Use this wrapper for one-shot Codex review, approach validation, or a delegated
second opinion. Read the shared lifecycle in
references/cross-ai-run.md before running it.
Provider adapter
- Check
command -v codex, thencodex --version. Readcodex --helpandcodex exec --helpwhen the installed version or requested scope is unclear. - Use the locally supported non-interactive command and output option. Choose the caller's model, or omit a model override for the configured default. Never pass a hardcoded model from this skill.
- Prefer the provider's least-privilege mode for review. Do not use an autonomous write or permission-bypass mode unless explicitly requested.
- Capture stdout/stderr according to the installed CLI's help, read the result,
and return the shared receipt. Historical
codex reviewversuscodex exec reviewflag differences belong inreference.md; verify them locally before use.
If codex is absent or needs an update, report the exact missing prerequisite
and stop. Installing or updating it is a separate user action; this skill never
runs npm i -g, curl | bash, or changes Codex settings.
Prompt requirements
The prompt is a cold-start handoff. Include the repository root, task path when task-attached, changed files or diff scope, requirements, and the specific questions to answer. Ask for findings or an approach only; the result does not authorize repository edits.
For task-attached calls, resolve ../setup/references/task-context.md and save
the result receipt in that task's evidence area. Standalone calls return the
result without creating a task.
When not to use
- The user asked for the primary review or implementation workflow only
- The request needs an interactive conversation
- The question is trivial or can be answered from local evidence
References
references/cross-ai-run.md— shared preflight, context, capture, and evidence lifecyclereference.md— exact flags only after checking the installed CLI; historical compatibility notestemplates.md— prompt shapes, with placeholders that must be resolved before execution