Marketplace

codex-cli

Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing

$ Installer

git clone https://github.com/rafaelcalleja/claude-market-place /tmp/claude-market-place && cp -r /tmp/claude-market-place/plugins/codex-cli-skill/skills/codex-cli ~/.claude/skills/claude-market-place

// tip: Run this command in your terminal to install the skill


name: codex-cli description: Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing

Codex Skill Guide

Running a Task

  1. Ask the user (via AskUserQuestion) which model to run: gpt-5.1 or gpt-5.1-codex or gpt-5.1-codex-max or gpt-5.1-mini.
  2. Ask the user (via AskUserQuestion) which reasoning effort to use: low, medium, or high.
  3. Select the sandbox mode required for the task; default to --sandbox read-only unless edits or network access are necessary.
  4. Assemble the command with the appropriate options:
    • -m, --model <MODEL>
    • --config model_reasoning_effort="<low|medium|high>"
    • --sandbox <read-only|workspace-write|danger-full-access>
    • --full-auto
    • -C, --cd <DIR>
    • --skip-git-repo-check
  5. When continuing a previous session, use codex exec resume --last via stdin. IMPORTANT: When resuming, you CANNOT specify model, reasoning effort, or other flags—the session retains all settings from the original run. Resume syntax: echo "your prompt here" | codex exec resume --last
  6. Run the command, capture stdout/stderr, and summarize the outcome for the user.

Quick Reference

Use caseSandbox modeKey flags
Read-only review or analysisread-only--sandbox read-only
Apply local editsworkspace-write--sandbox workspace-write --full-auto
Permit network or broad accessdanger-full-access--sandbox danger-full-access --full-auto
Resume recent sessionInherited from originalecho "prompt" | codex exec resume --last (no flags allowed)
Run from another directoryMatch task needs-C <DIR> plus other flags

Following Up

  • After every codex command, immediately use AskUserQuestion to confirm next steps, collect clarifications, or decide whether to resume with codex exec resume --last.
  • When resuming, pipe the new prompt via stdin: echo "new prompt" | codex exec resume --last. The resumed session automatically uses the same model, reasoning effort, and sandbox mode from the original session.
  • Restate the chosen model, reasoning effort, and sandbox mode when proposing follow-up actions.

Error Handling

  • Stop and report failures whenever codex --version or a codex exec command exits non-zero; request direction before retrying.
  • Before you use high-impact flags (--full-auto, --sandbox danger-full-access, --skip-git-repo-check) ask the user for permission using AskUserQuestion unless it was already given.
  • When output includes warnings or partial results, summarize them and ask how to adjust using AskUserQuestion.