| name | codex-review |
| description | Run a blocking, non-interactive Codex review of the working tree and return findings verbatim. Use when automation (ralph, work, pre-commit gates) needs a one-shot review without the interactive wait-vs-background prompt. |
| allowed-tools | Bash |
Codex Working-Tree Review
One-shot, non-interactive review of the current working tree (staged + unstaged + untracked). Blocks
until Codex finishes and prints findings verbatim.
The slash-command /codex:review is interactive — it asks whether to wait or run in the background.
This skill wraps the underlying codex-companion.mjs script with --wait --scope working-tree so
it is safe to call from autonomous loops.
When to use
ralph / work skills or any automation that needs a review without prompts.- A pre-commit gate before the skill commits its work.
Not for: branch-level reviews across many commits (use /codex:review --scope branch manually),
adversarial or design reviews (use /codex:adversarial-review), or Codex-driven fixing (use
/codex:rescue).
Pre-flight
Codex must be installed and authenticated. If the command fails with "codex plugin missing" or an
auth error, run /codex:setup and retry.
Run
CODEX=$(ls -d ~/.claude/plugins/cache/openai-codex/codex/*/scripts/codex-companion.mjs 2>/dev/null | sort -V | tail -1)
[ -z "$CODEX" ] && { echo "codex plugin missing — run /codex:setup" >&2; exit 1; }
node "$CODEX" review --wait --scope working-tree
--wait runs in the foreground and blocks until complete — no polling needed.--scope working-tree covers staged, unstaged, and untracked files (equivalent to the old
roborev review --dirty).- stdout is the full Codex verdict. Return it verbatim — do not paraphrase.
Cost guardrail
Each invocation is a paid Codex call. Never re-run on an unchanged working tree to "retry".
Callers (ralph, work) enforce their own per-issue review budget; this skill does not.
Output contract
Codex prints a block containing: verdict, summary, findings (severity + file:line + description),
and any follow-up suggestions. The calling skill consumes that block directly — no further
processing here.
