Add VHS support

.codespellrc

@@ -1,6 +1,6 @@
 [codespell]
 # Ref: https://github.com/codespell-project/codespell#using-a-config-file
-skip = .git*,vendor,*-lock.yaml,*.lock,.codespellrc,*test.ts,*.jsonl
+skip = .git*,vendor,*-lock.yaml,*.lock,.codespellrc,*test.ts,*.jsonl,frame*.txt
 check-hidden = true
 ignore-regex = ^\s*"image/\S+": ".*|\b(afterAll)\b
 ignore-words-list = ratatui,ser

.github/dotslash-config.json

@@ -27,6 +27,34 @@
           "path": "codex.exe"
         }
       }
+    },
+    "codex-responses-api-proxy": {
+      "platforms": {
+        "macos-aarch64": {
+          "regex": "^codex-responses-api-proxy-aarch64-apple-darwin\\.zst$",
+          "path": "codex-responses-api-proxy"
+        },
+        "macos-x86_64": {
+          "regex": "^codex-responses-api-proxy-x86_64-apple-darwin\\.zst$",
+          "path": "codex-responses-api-proxy"
+        },
+        "linux-x86_64": {
+          "regex": "^codex-responses-api-proxy-x86_64-unknown-linux-musl\\.zst$",
+          "path": "codex-responses-api-proxy"
+        },
+        "linux-aarch64": {
+          "regex": "^codex-responses-api-proxy-aarch64-unknown-linux-musl\\.zst$",
+          "path": "codex-responses-api-proxy"
+        },
+        "windows-x86_64": {
+          "regex": "^codex-responses-api-proxy-x86_64-pc-windows-msvc\\.exe\\.zst$",
+          "path": "codex-responses-api-proxy.exe"
+        },
+        "windows-aarch64": {
+          "regex": "^codex-responses-api-proxy-aarch64-pc-windows-msvc\\.exe\\.zst$",
+          "path": "codex-responses-api-proxy.exe"
+        }
+      }
     }
   }
 }

.github/prompts/issue-deduplicator.txt

@@ -0,0 +1,18 @@
+You are an assistant that triages new GitHub issues by identifying potential duplicates.
+
+You will receive the following JSON files located in the current working directory:
+- `codex-current-issue.json`: JSON object describing the newly created issue (fields: number, title, body).
+- `codex-existing-issues.json`: JSON array of recent issues (each element includes number, title, body, createdAt).
+
+Instructions:
+- Load both files as JSON and review their contents carefully. The codex-existing-issues.json file is large, ensure you explore all of it.
+- Compare the current issue against the existing issues to find up to five that appear to describe the same underlying problem or request.
+- Only consider an issue a potential duplicate if there is a clear overlap in symptoms, feature requests, reproduction steps, or error messages.
+- Prioritize newer issues when similarity is comparable.
+- Ignore pull requests and issues whose similarity is tenuous.
+- When unsure, prefer returning fewer matches.
+
+Output requirements:
+- Respond with a JSON array of issue numbers (integers), ordered from most likely duplicate to least.
+- Include at most five numbers.
+- If you find no plausible duplicates, respond with `[]`.

.github/prompts/issue-labeler.txt

@@ -0,0 +1,26 @@
+You are an assistant that reviews GitHub issues for the repository.
+
+Your job is to choose the most appropriate existing labels for the issue described later in this prompt.
+Follow these rules:
+- Only pick labels out of the list below.
+- Prefer a small set of precise labels over many broad ones.
+- If none of the labels fit, respond with an empty JSON array: []
+- Output must be a JSON array of label names (strings) with no additional commentary.
+
+Labels to apply:
+1. bug — Reproducible defects in Codex products (CLI, VS Code extension, web, auth).
+2. enhancement — Feature requests or usability improvements that ask for new capabilities, better ergonomics, or quality-of-life tweaks.
+3. extension — VS Code (or other IDE) extension-specific issues.
+4. windows-os — Bugs or friction specific to Windows environments (PowerShell behavior, path handling, copy/paste, OS-specific auth or tooling failures).
+5. mcp — Topics involving Model Context Protocol servers/clients.
+6. codex-web — Issues targeting the Codex web UI/Cloud experience.
+8. azure — Problems or requests tied to Azure OpenAI deployments.
+9. documentation — Updates or corrections needed in docs/README/config references (broken links, missing examples, outdated keys, clarification requests).
+10. model-behavior — Undesirable LLM behavior: forgetting goals, refusing work, hallucinating environment details, quota misreports, or other reasoning/performance anomalies.
+
+Issue information is available in environment variables:
+
+ISSUE_NUMBER
+ISSUE_TITLE
+ISSUE_BODY
+REPO_FULL_NAME

.github/workflows/ci.yml

@@ -1,7 +1,7 @@
 name: ci
 
 on:
-  pull_request: { branches: [main] }
+  pull_request: {}
   push: { branches: [main] }
 
 jobs:
@@ -27,12 +27,29 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      # Run all tasks using workspace filters
+      # stage_npm_packages.py requires DotSlash when staging releases.
+      - uses: facebook/install-dotslash@v2
 
-      - name: Ensure staging a release works.
+      - name: Stage npm package
+        id: stage_npm_package
         env:
           GH_TOKEN: ${{ github.token }}
-        run: ./codex-cli/scripts/stage_release.sh
+        run: |
+          set -euo pipefail
+          CODEX_VERSION=0.40.0
+          OUTPUT_DIR="${RUNNER_TEMP}"
+          python3 ./scripts/stage_npm_packages.py \
+            --release-version "$CODEX_VERSION" \
+            --package codex \
+            --output-dir "$OUTPUT_DIR"
+          PACK_OUTPUT="${OUTPUT_DIR}/codex-npm-${CODEX_VERSION}.tgz"
+          echo "pack_output=$PACK_OUTPUT" >> "$GITHUB_OUTPUT"
+
+      - name: Upload staged npm package artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: codex-npm-staging
+          path: ${{ steps.stage_npm_package.outputs.pack_output }}
 
       - name: Ensure root README.md contains only ASCII and certain Unicode code points
         run: ./scripts/asciicheck.py README.md

.github/workflows/codespell.yml

@@ -22,7 +22,6 @@ jobs:
       - name: Annotate locations with typos
         uses: codespell-project/codespell-problem-matcher@b80729f885d32f78a716c2f107b4db1025001c42 # v1
       - name: Codespell
-        uses: codespell-project/actions-codespell@406322ec52dd7b488e48c1c4b82e2a8b3a1bf630 # v2
+        uses: codespell-project/actions-codespell@406322ec52dd7b488e48c1c4b82e2a8b3a1bf630 # v2.1
         with:
           ignore_words_file: .codespellignore
-          skip: frame*.txt

.github/workflows/generate-vhs-gifs.yml

@@ -0,0 +1,196 @@
+name: Render VHS GIFs
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'docs/tapes/**'
+      - '.github/workflows/generate-vhs-gifs.yml'
+  pull_request:
+    paths:
+      - 'docs/tapes/**'
+      - '.github/workflows/generate-vhs-gifs.yml'
+
+jobs:
+  render-gifs:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Ensure GIF output directory exists
+        run: mkdir -p docs/gifs
+
+      - name: Setup FFmpeg
+        uses: FedericoCarboni/setup-ffmpeg@v3
+
+      - run: sudo apt-get update && sudo apt-get install -y ttyd
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version: '1.25'
+      - run: go install github.com/charmbracelet/vhs@v0.10.0
+      - run: $(go env GOPATH)/bin/vhs ./docs/tapes/*.tape
+
+      - name: Upload GIFs artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: vhs-gifs
+          path: docs/gifs
+          if-no-files-found: warn
+
+  comment-on-pr:
+    needs: render-gifs
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Download GIFs artifact
+        id: download-artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: vhs-gifs
+          path: gifs
+        continue-on-error: true
+
+      - name: Build PR comment with GIFs
+        env:
+          DOWNLOAD_OUTCOME: ${{ steps.download-artifacts.outcome }}
+        run: |
+          set -euo pipefail
+          mkdir -p gifs
+          shopt -s nullglob
+          gifs=(gifs/*.gif)
+          {
+            echo "<!-- vhs-gifs-comment -->"
+            echo "## Rendered VHS GIFs"
+            echo
+            if [ "${DOWNLOAD_OUTCOME}" != "success" ]; then
+              echo "No GIF artifacts were available for this run."
+            elif [ "${#gifs[@]}" -eq 0 ]; then
+              echo "No GIFs were generated."
+            else
+              for gif in "${gifs[@]}"; do
+                filename=$(basename "${gif}")
+                base64_data=$(base64 -w0 "${gif}")
+                echo "<details>"
+                echo "<summary>${filename}</summary>"
+                echo
+                echo "![${filename}](data:image/gif;base64,${base64_data})"
+                echo
+                echo "</details>"
+                echo
+              done
+            fi
+          } > vhs_comment.md
+
+      - name: Find existing VHS comment
+        id: find-vhs-comment
+        uses: peter-evans/find-comment@v3
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: '<!-- vhs-gifs-comment -->'
+
+      - name: Comment on PR with GIFs
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-id: ${{ steps.find-vhs-comment.outputs.comment-id }}
+          body-path: vhs_comment.md
+
+  comment-on-commit:
+    needs: render-gifs
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || github.event_name == 'push'
+    steps:
+      - name: Download GIFs artifact
+        id: download-artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: vhs-gifs
+          path: gifs
+        continue-on-error: true
+
+      - name: Build commit comment with GIFs
+        env:
+          DOWNLOAD_OUTCOME: ${{ steps.download-artifacts.outcome }}
+        run: |
+          set -euo pipefail
+          mkdir -p gifs
+          shopt -s nullglob
+          gifs=(gifs/*.gif)
+          {
+            echo "<!-- vhs-gifs-comment -->"
+            echo "## Rendered VHS GIFs"
+            echo
+            if [ "${DOWNLOAD_OUTCOME}" != "success" ]; then
+              echo "No GIF artifacts were available for this run."
+            elif [ "${#gifs[@]}" -eq 0 ]; then
+              echo "No GIFs were generated."
+            else
+              for gif in "${gifs[@]}"; do
+                filename=$(basename "${gif}")
+                base64_data=$(base64 -w0 "${gif}")
+                echo "<details>"
+                echo "<summary>${filename}</summary>"
+                echo
+                echo "![${filename}](data:image/gif;base64,${base64_data})"
+                echo
+                echo "</details>"
+                echo
+              done
+            fi
+          } > vhs_comment.md
+
+      - name: Determine commit SHA
+        id: commit-sha
+        run: |
+          set -euo pipefail
+          if [ "${GITHUB_EVENT_NAME}" = "pull_request" ] && [ -n "${PULL_REQUEST_SHA}" ]; then
+            echo "sha=${PULL_REQUEST_SHA}" >> "$GITHUB_OUTPUT"
+          else
+            echo "sha=${GITHUB_SHA}" >> "$GITHUB_OUTPUT"
+          fi
+        env:
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+          PULL_REQUEST_SHA: ${{ github.event.pull_request.head.sha || '' }}
+          GITHUB_SHA: ${{ github.sha }}
+
+      - name: Find existing commit comment
+        id: find-commit-comment
+        run: |
+          set -euo pipefail
+          comment_id=""
+          if [ -n "${COMMIT_SHA}" ]; then
+            comment_id=$(gh api repos/${GITHUB_REPOSITORY}/commits/${COMMIT_SHA}/comments \
+              --jq 'map(select(.body | contains("<!-- vhs-gifs-comment -->"))) | .[0].id // empty' || true)
+          fi
+          if [ -n "${comment_id}" ]; then
+            echo "comment-id=${comment_id}" >> "$GITHUB_OUTPUT"
+          fi
+        env:
+          COMMIT_SHA: ${{ steps.commit-sha.outputs.sha }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Upsert commit comment with GIFs
+        if: steps.find-commit-comment.outputs.comment-id != ''
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          token: ${{ github.token }}
+          comment-id: ${{ steps.find-commit-comment.outputs.comment-id }}
+          body-path: vhs_comment.md
+
+      - name: Create commit comment with GIFs
+        if: steps.find-commit-comment.outputs.comment-id == '' && steps.commit-sha.outputs.sha != ''
+        env:
+          COMMIT_SHA: ${{ steps.commit-sha.outputs.sha }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          gh api repos/${GITHUB_REPOSITORY}/commits/${COMMIT_SHA}/comments \
+            -X POST \
+            -F body=@vhs_comment.md > /dev/null