codex-review

Codex Review

Delegate code review of staged git changes to Codex CLI using a role-specific critique lens, keeping raw output out of Claude Code's context window.

Personas

Argument	Reviewer Voice
distinguished	Distinguished Engineer — architectural depth, long-term maintainability, systems thinking
sre	Mid-level SRE/DevOps Engineer — operational concerns, deployment risk, observability, toil reduction
team	Five named reviewers in separate sections: Senior Security Engineer, Junior Security Engineer, Staff SRE, Mid-level Reliability Engineer, Principal DevOps Engineer

Usage

When this skill triggers, first confirm staged changes exist, then run:

"${CLAUDE_PLUGIN_ROOT}/skills/codex-review/scripts/codex-review.sh" "<persona>"

Valid persona values: distinguished, sre, team.

If the user hasn't specified a persona, ask which one they want before running the script.

What the Script Does

• Validates that staged changes exist (exits early with a clear message if git diff --staged is empty)
• Validates the persona argument
• Injects persona-specific system prompt and the staged diff into Codex CLI
• Captures output and writes a JSON artifact to ~/.claude/cli-reviews/
• Prints formatted markdown to stdout

Presenting Results

Present the markdown output the script prints to stdout. Do not add your own code review on top of it. If the user wants your opinion afterward, they will ask.

If the script exits non-zero, report the error message it printed.

Artifact Location

Each run writes one JSON file to ~/.claude/cli-reviews/codex-review-<persona>-<timestamp>.json. Mention the artifact path at the end of your response.