Run Codex CLI for $ARGUMENTS .

Prerequisites

• Verify Codex CLI is installed: command -v codex .

• If not found, instruct user: npm install -g @openai/codex

• Verify authentication: codex auth status or attempt a simple command.

• If not authenticated, instruct user: codex auth login

• If both checks fail and user cannot install, fall back to manual web search tools (WebSearch, WebFetch).

Steps

• If $ARGUMENTS empty, ask user for task description.

• Determine capability:

• Code Generation: tasks involving code analysis, refactoring, generation.

• Web Search: tasks requiring online research, documentation lookup.

• For Code Generation, run: codex e -m gpt-5.3-codex -c model_reasoning_effort=xhigh
  --dangerously-bypass-approvals-and-sandbox
  --skip-git-repo-check
  -C <workdir>
  "<task>"

⚠️ Safety note: --dangerously-bypass-approvals-and-sandbox disables all confirmation prompts and filesystem sandboxing. This is required for automated execution but means Codex can modify/delete files without asking. Only use in controlled environments.

• For Web Search, run: codex e -m gpt-5.3-codex -c model_reasoning_effort=high
  --enable web_search_request
  --dangerously-bypass-approvals-and-sandbox
  --skip-git-repo-check
  "<task>"

• To resume a session, run: codex e resume <session_id> "<follow-up>" .

• Read $SKILL_DIR/references/REFERENCE.md for parameters and examples.

Model Selection

• Default: gpt-5.3-codex (best for code tasks)

• Override via -m <model> flag (e.g., -m gpt-5 for general reasoning)

• User can also set default model in ~/.codex/config.toml under [model]

Error Handling

Problem Solution

codex: command not found

Install: npm install -g @openai/codex

Authentication error Run codex auth login

Rate limit / timeout Retry with lower model_reasoning_effort

CLI unavailable & cannot install Fall back to WebSearch / WebFetch tools