Request Review

• ~/.codex/skills/request-review/scripts/request-review <tmux-pane-target> <commit-message>

• ~/.codex/skills/request-review/scripts/request-review "coolproject-78-dialpad:1.1" "fix: address review findings"

• ~/.codex/skills/request-review/scripts/request-review "%9" "chore: review checkpoint"

%<pane-id>

<session>:<window-index>.<pane-index>

Preferred workflow

• If explicitly asked to use this skill, do not manually commit/push first.
• Run this skill directly and let it handle commit/push in the default path.
• Use the opt-in existing-commit mode only as recovery when a commit was already created/pushed by mistake.
• Wait for review, do not finish your turn until the agent is done reviewing your code.
• Take remediary action as needed and request another review.
• If you pass, this is a good stopping point.

Behavior

• Default path: commits first using the provided commit message (

  git add -A

  then

  git commit -m ...

  ).
• Default path: uses the newly created

  HEAD

  commit as the target review SHA.
• Opt-in recovery path: set

  REQUEST_REVIEW_USE_EXISTING_COMMIT=1

  to skip

  git add

  /

  git commit

  and review an existing commit (defaults to

  HEAD

  , or

  REQUEST_REVIEW_EXISTING_COMMIT_SHA

  ).
• Runs exactly one review request at a time (global lock).
• Sends final review text back to the target pane, waits 5 seconds, then sends Enter.

Mode switch (from

.env

)

• REQUEST_REVIEW_MODE=remote

  • Default path pushes branch (

    git push -u origin HEAD

    ).
  • With

    REQUEST_REVIEW_USE_EXISTING_COMMIT=1

    , skips push and hooks review onto the existing commit SHA.
  • Finds the PR for current branch.
  • Posts

    @codex review

    to trigger cloud review explicitly.
  • Polls until one condition is met for the target commit SHA:
    1. New inline PR review comment(s) from

       chatgpt-codex-connector[bot]

       on that commit.
    2. New

       +1

       reaction from

       chatgpt-codex-connector[bot]

       on the PR issue after the commit timestamp.
  • If inline comments exist, returns detailed findings with links.
  • If only thumbs-up exists, returns

    👍

    summary.

• REQUEST_REVIEW_MODE=local

  • Runs

    codex exec -s read-only --json review --commit <sha> --title <commit-message>

    in the current repo.
  • Uses

    REQUEST_REVIEW_LOCAL_PROFILE

    from

    .env

    and reads model/reasoning from that profile in

    ~/.codex/config.toml

    .
  • If the profile is missing in

    config.toml

    , exits with an error.
  • Writes output to

    review.log

    and stderr to

    review.err.log

    .

Config source

• ~/.codex/skills/request-review/.env

• REQUEST_REVIEW_MODE=local|remote

• REQUEST_REVIEW_BOT_LOGIN=chatgpt-codex-connector[bot]

• REQUEST_REVIEW_TRIGGER_COMMENT=@codex review

• REQUEST_REVIEW_POLL_INTERVAL_SECONDS=20

• REQUEST_REVIEW_TIMEOUT_SECONDS=1800

• REQUEST_REVIEW_LOCAL_PROFILE=local-review

• REQUEST_REVIEW_USE_EXISTING_COMMIT=0|1

  (default

  0

  )

• REQUEST_REVIEW_EXISTING_COMMIT_SHA=<sha-or-ref>

  (default

  HEAD

  when existing-commit mode is enabled)

Critical discipline

• Only run one review request at a time.
• Do not launch concurrent review requests.