name: codex
binary: codex
aliases: []
category: agent
summary: OpenAI Codex command-line coding agent.
homepage: https://github.com/openai/codex
docs: https://github.com/openai/codex#readme
detect:
version_args: ["--version"]
local:
files: ["AGENTS.md"]
dirs: [".codex"]
package_json:
package_manager_prefixes: []
use_when:
- Run Codex agent workflows or inspect Codex project instructions
avoid_when:
- The task should stay within the current agent session
risk:
level: high
effects:
- execute_code
- network_access
- write_files
- secret_exposure
requires_auth: true
destructive: false
confirmation_required_for:
- running autonomous edits
guardrails:
- Read AGENTS.md before starting repository work.