| name | codex-runtime |
| description | Codex runtime/session control: use Codex CLI slash commands and CLI flags to manage sessions, approvals, models, resumes/forks, and safe restarts in a worker terminal. Trigger when the controller needs to operate the Codex CLI like a human. |
Codex Runtime
Overview
Operate the Codex CLI safely: manage session state, approvals, models, resume/fork, and clean restarts from a worker terminal.
Session Safety
- Confirm idle state
- Snapshot and/or
status the worker; do not intervene mid-run.
- Only proceed when the worker is at a prompt or explicitly idle.
- Prefer in-session resets
- Use
/new for a fresh conversation without leaving the CLI.
- Use
/compact to summarize after long runs.
- Use
/status to confirm model, approvals, and sandbox before new work.
- Full reset (only between tasks)
- Use
/exit (or /quit) to leave the CLI.
- Relaunch with the appropriate flags only when a fresh context is materially helpful.
Core Slash Commands (Codex CLI)
Use /help (or /) to see the full list. Common commands:
/model change the active model./status show current model, approvals, and sandbox./permissions manage approvals (alias /approvals)./new start a fresh conversation./compact summarize the conversation./diff view Git diff./review request a review of the working tree./mcp list or manage MCP servers/tools./resume resume a saved conversation./fork fork a saved conversation./apps, /ps, /personality, /mention for additional session controls./init, /logout, /feedback, /undo for setup/cleanup./exit or /quit to exit the CLI.
Resume / Fork (Shell)
codex resume open the interactive resume picker.codex resume --last resume the most recent session.codex resume --all list sessions across projects.codex resume <SESSION_ID> resume a specific session.codex exec resume --last "..." resume and immediately send a prompt.codex fork <SESSION_ID> fork an existing session.
Launch Flags (Shell)
Use these when starting Codex from the shell (not inside the CLI):
--model choose a model at launch.--profile select a saved profile.--oss use the open-source instructions mode.--ask-for-approval set approval behavior.--sandbox choose sandbox mode.--full-auto low-friction local work (approval on-request + workspace-write).--yolo (aka --dangerously-bypass-approvals-and-sandbox) disables approvals and sandboxing. Use only when explicitly allowed.--search enable live web search instead of cached.--cd set working directory before the session starts.--add-dir grant additional writable directories.--config use a custom config file.--image include images with the first prompt.--enable / --disable toggle specific Codex features.
Guardrails
- Do not send Ctrl+C or Ctrl+D to exit; use
/exit.
- Never restart mid-run.
- Use
/status after model or approval changes to confirm settings.
- If the worker is not Codex, switch to the model-specific runtime skill instead.
