Codex Executor

Use Codex CLI as an execution worker. The parent Agent owns judgment, planning, supervision, and acceptance; the CLI carries out a bounded assignment.

Workflow

1. Choose the assignment. Finish the decisions that shape the work, then delegate a unit whose remaining effort is substantial, whose boundary is clear, and whose result can be checked. State the unit and its acceptance signals before launch.

   • Completion criterion: the parent Agent can describe exactly what the CLI should accomplish and how the parent will judge the result.

2. Resolve the profile and context. Use the profile named by the user exactly as given. When none was named, list the *.config.toml files under ${CODEX_HOME:-$HOME/.codex}, present their names without the suffix, and ask the user to select one. Resolve the target workspace and whether it is intentionally outside a Git repository, then give the worker the objective, decisions already made, relevant input pointers, and acceptance conditions that it cannot discover from the workspace. Treat the selected profile, Codex base configuration, and workspace as the authority for model, provider, reasoning, authentication, sandbox, approval, instructions, skills, and tools.

   • Completion criterion: one user-selected profile, one workspace, and the task-specific context are ready. If no profile is configured, report that prerequisite and stop.

3. Run and wait. Start one non-TTY process and supply the complete task at launch through a safely quoted argument or complete stdin: