agentskillexchange Run bounded Codex jobs inside GitHub Actions for PR review and repo maintenance with codex-action
Use codex-action when an agent operator wants Codex to run inside GitHub Actions for PR review or scheduled repo work with explicit workflow permissions, prompts, and CI boundaries.
Prerequisites
GitHub Actions, a repository workflow file, Codex Action, and the required provider API secret configured in GitHub.
Installation
Requirements and caveats from upstream:
- Users must provide an API key for their chosen provider (for example, OPENAI_API_KEY or AZURE_OPENAI_API_KEY if using Azure for OpenAI models) as a [GitHub Actions sec...
- Linux/macOS: All options for safety-strategy are supported. Again, if you pick drop-sudo, remember that later steps in your job that rely on sudo will fail. If you do need to run code that requires sudo after open...
- The responses-api-endpoint must be set to the full URL (including any required query parameters) that Codex will POST to for a Responses API request. For Azure, this might look like https://YOUR_PROJECT_NAME.openai.az...
Basic usage or getting-started notes:
Run Codex from a GitHub Actions workflow while keeping tight control over the privileges available to Codex. This action handles installing the Codex CLI and configuring i...
Example: Create Your Own Pull Request Bot
While Codex cloud offers a powerful code review tool that you can use today, here is an example of how you can build your own code review workflow with openai/c...
Extracted from upstream docs: https://raw.githubusercontent.com/openai/codex-action/HEAD/README.md