codex-review-plan

Codex Plan Review

Send the current plan to Codex CLI for an independent review. Codex runs in ephemeral read-only mode and returns structured feedback.

Workflow

Step 1: Locate the Plan File

Determine which plan to review:

• If the user specified a file path, use that path directly.
• Otherwise, find the most recently modified plan file:

ls -t ~/.claude/plans/*.md 2>/dev/null | head -1

If no plan file is found, inform the user that no plan was found and ask them to specify a path.

Read the plan file to confirm it has content before proceeding.

Step 2: Execute Codex Review

Run the Codex CLI in non-interactive ephemeral mode. Use a 5-minute timeout since model inference can take time.

codex exec --ephemeral -o /tmp/codex-plan-review.md \
  "You are reviewing an implementation plan. Analyze it for:
- Logical gaps or missing steps
- Incorrect assumptions about the codebase or dependencies
- Risks and potential failure modes
- Ordering issues (steps that should come earlier or later)
- Missing error handling or edge cases
- Opportunities for simplification

Be specific and actionable. Reference specific sections of the plan in your feedback." \
  < <plan-file-path>

Set Bash timeout to 300000 (5 minutes).

Step 3: Present Results

Read /tmp/codex-plan-review.md and present the review to the user.

Format the output with a clear header:

## Codex Plan Review

<review content>

Clean up the temp file after reading:

rm -f /tmp/codex-plan-review.md

Error Handling

• If codex is not found: inform the user to install Codex CLI (npm install -g @openai/codex)
• If codex returns an error: show the error output and suggest checking authentication (codex login)
• If the plan file is empty: inform the user and do not invoke codex