Drop-in Codex AI agent with GitHub Models

_CODEX_GITHUB_MODELS.md

This is a drop-in, zero-config Actions harness for OpenAI's Codex agent. It uses GitHub Models for inference, so you don't need to set up any secrets - just copy-pasting the action into your repo should work as-is.

You may need to go into your settings and check the "allow Actions to open PRs" checkbox.

To use it, open an issue in your repo with [codex] in the issue name.

Note: I've updated this to work for the latest version of Codex (the Rust one). If you're using the Python one, you'll have to go to a previous version of this Gist.

codex.yml

name: Codex on GitHub Models

on:
  issues:
    types: [opened]

jobs:
  process-issue:
    if: contains(github.event.issue.title, '[codex]')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write
      models: read

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '22'

      - name: Install Codex CLI
        run: npm install -g @openai/codex

      - name: Process issue with Codex
        env:
          ISSUE_BODY: ${{ github.event.issue.body }}
          ISSUE_NUMBER: ${{ github.event.issue.number }}
          ISSUE_TITLE: ${{ github.event.issue.title }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          INSTRUCTION="$ISSUE_TITLE  --- $ISSUE_BODY"
          
          BRANCH_NAME="codex/issue-$ISSUE_NUMBER"
          git checkout -b $BRANCH_NAME

          codex exec \
            -c model=gpt-4.1 \
            -c model_provider=github \
            -c 'model_providers.github={name="GitHub Models", base_url="https://models.github.ai/inference", env_key="GH_TOKEN", wire_api="chat"}' \
            --full-auto "$INSTRUCTION"
          
          if [[ -n $(git status --porcelain) ]]; then
            git config user.name "GitHub Models Codex Bot"
            git config user.email "[email protected]"
            
            git add .
            git commit -m "Codex changes for issue #$ISSUE_NUMBER"
            git push origin $BRANCH_NAME
            
            # Create PR and comment on issue using the same token
            gh pr create --title "Codex: ${{ github.event.issue.title }}" \
              --body "Auto-generated by Codex for issue #$ISSUE_NUMBER" \
              --base ${{ github.event.repository.default_branch }} \
              --head $BRANCH_NAME
              
            gh issue comment $ISSUE_NUMBER --body "Codex created a PR for this issue"
          else
            gh issue comment $ISSUE_NUMBER --body "Codex processed this issue but made no changes"
          fi

Hi thank you for this, can you share few example prompts (in the issue) that you used if you don't mind, doesnt matter what i specify in the body i always run into "Codex processed this issue but made no changes".

I tried it with some test prompts like "can you remove this Action workflow I'm not using", or "can you add a README to this project". I think you could probably remove --quiet and read the workflow log to get a better sense of what Codex is doing and thinking about.

when i removed the --quiet, i get the following error "Please pass one of apiKey and azureADTokenProvider or set the AZURE_OPENAI_API_KEY environment ", not sure how just removing this has caused the issue, will continue to investigate over the weekend and keep you posted... thank you.

I get: error: unexpected argument '--approval-mode' found

@silidev @madhugilla Codex updated to a new version with a different interface. I've updated this Gist so it works now.