skills.rest
windmill-labs
windmill-labsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

local-review-codex

Runs the CI Codex PR review locally against unpushed branch changes before pushing.

17.8k|1.1k|Updated May 5, 2022
Search Tags:#openai#pre-push#ci#CODEX#Git diff#Code review#Pull request
One-click install
npx skills add https://github.com/windmill-labs/windmill --skill local-review-codex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-review-codex
Source: https://github.com/windmill-labs/windmill/tree/main/.agents/skills/local-review-codex
Command: npx skills add https://github.com/windmill-labs/windmill --skill local-review-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex, and includes scripts (resource) components.

What problem does it solve?

CI-based code review only runs after you push a PR, so issues surface late. This Skill runs the exact same Codex review policy, model, and reasoning effort as the codex-pr-review GitHub Action locally, covering both committed and uncommitted work, so you catch findings before pushing.

Core Features & Use Cases

  • CI-parity review: Uses the same REVIEW.md policy, gpt-5.6-sol model, and xhigh reasoning effort as the codex-pr-review workflow, producing P0/P1/P2 findings with file:line references.
  • Pre-push scope: Diffs the current branch against the merge-base with a base ref (default main), folding in uncommitted edits and explicitly listing untracked files for review.
  • Read-only sandbox: Runs codex exec in read-only mode so the review cannot modify the working tree, writing only temp files.
  • Use Case: Before pushing a non-trivial feature branch, run the script to get the same review CI would produce, then decide with your team whether to address findings first.

Quick Start

Run the local Codex review on my current branch against main before I push.

Frequently Asked Questions about local-review-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Codex code review locally before pushing?▼

Run bash .agents/skills/local-review-codex/run.sh from the repository, optionally passing a base ref other than main. The script diffs your branch against the merge-base, includes uncommitted changes, and prints the Codex review with P0/P1/P2 findings.

Does the local Codex review match the CI PR review?▼

Yes, it uses the same REVIEW.md policy, the gpt-5.6-sol model, and xhigh reasoning effort as the codex-pr-review GitHub Action. The differences are scope (unpushed work including uncommitted edits) and a read-only sandbox instead of full access.

What version of the codex CLI is required?▼

The codex CLI must be version 0.144.1 or newer, since older versions reject the gpt-5.6-sol model. Install or upgrade with npm install --global @openai/[email protected] and authenticate via codex login or OPENAI_API_KEY.

Why does the review miss untracked files in git diff?▼

git diff never includes untracked files, so the script gathers them separately with git ls-files and lists them in the prompt. Codex is instructed to read each untracked path directly and treat its entire contents as newly added.

Can the local Codex review modify my working tree?▼

No, the script runs codex exec with the read-only sandbox flag, so Codex can read the diff and files but cannot modify anything. It writes only temporary files that are cleaned up on exit.

Related Skills

Explore More Software Engineering Skills→
0xdeafcafe0xdeafcafe

review-change

Audit git working tree diffs read-only and report severity-grouped findings.

Community
Advanced
jrmatherlyjrmatherly

pr-gates

Enforce preflight and gate-pr checks for pull requests with review evidence.

Community
Advanced
RobinNorbergRobinNorberg
5

critique

Review unpushed git commits and generate PASS/FAIL reports with fixes.

Community
Advanced
pydanticpydantic
19.6k

pre-push-review

Reviews the current branch diff against a base branch before pushing to GitHub.

Official
Intermediate