GitHub Integration: Surface Codex Cloud PR Reviews as GitHub Check Runs

What variant of Codex are you using?

App, CLI

What feature would you like to see?

Feature Request

Problem

When Codex Cloud automatically reviews a pull request through the GitHub integration, there is currently no visible GitHub Check or Status Check indicating that the review is in progress.

As a PR author, I cannot easily tell whether:

• Codex has started reviewing
• Codex is still reviewing
• Codex is queued
• Codex timed out
• Codex failed
• Codex completed successfully

The only reliable way to determine review status today is to wait for review comments to appear or navigate to the Codex Cloud review dashboard.

Proposed Solution

Create a GitHub Check Run for Codex Cloud reviews.

Suggested states:

• Pending: Review queued or running
• Success: Review completed
• Failure: Review failed
• Cancelled: Review aborted
• Timed Out: Review exceeded execution limits

Benefits

1. Eliminates uncertainty about whether a review is still running.
2. Allows developers to stay entirely within GitHub.
3. Enables branch protection rules that require Codex review completion.
4. Makes Codex Cloud reviews behave consistently with other asynchronous CI systems.
5. Reduces the need to repeatedly check the Codex dashboard.

Additional Notes

This request is specifically for the built-in Codex Cloud GitHub review integration and not the Codex GitHub Action.

The GitHub Action already provides CI status because it runs inside GitHub Actions. The gap is that the managed Codex Cloud review workflow currently has no corresponding status indicator in GitHub.

Additional information

_No response_