codex-e2e-test
FeaturedRun PR-grade real Codex E2E validation through claude-tap, including resume turns, multiple tool calls, optional image input, viewer verification, and screenshot evidence.
Testing & QA 3,113 stars
267 forks Updated yesterday MIT
Install
Quality Score: 96/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Codex E2E Test Skill
Run real end-to-end validation that starts `claude-tap` from local source,
connects to the real Codex CLI via OAuth, captures OpenAI Responses API traces,
and produces viewer screenshots suitable for PR evidence.
Use this skill for every PR that changes capture, proxying, viewer rendering,
session/dashboard behavior, client launch logic, trace ordering, content blocks,
tools, token usage, or screenshot/demo assets. If a PR cannot run this flow,
state why in the PR and cover the same risk with another real client trace.
## Prerequisites
- `codex` CLI installed (`npm install -g @openai/codex`) and authenticated via OAuth
- Python dev dependencies: `uv sync --extra dev`
- Playwright installed: `uv run playwright install chromium`
Verify OAuth works:
```bash
codex exec "say hello" --dangerously-bypass-approvals-and-sandbox
```
If it fails with token errors, re-authenticate:
```bash
codex auth login
```
## Key Difference from Claude E2E
Codex uses the **OpenAI Responses API** (`/v1/responses`) instead of Anthropic Messages API.
With OAuth authentication, the upstream is `https://chatgpt.com/backend-api/codex`,
**not** `https://api.openai.com`.
The proxy must be told the correct target with `--tap-target`.
## Run a Real Codex E2E Trace
Prefer the resume + multimodal flow below for PR evidence. The simple commands
are only smoke tests for checking local setup.
### Simple (single tool call)
```bash
claude-tap --tap-client codex \
--tap-target h...
Details
- Author
- liaohch3
- Repository
- liaohch3/claude-tap
- Created
- 6 months ago
- Last Updated
- yesterday
- Language
- Python
- License
- MIT
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
codex
Use when Claude wants a read-only second opinion from OpenAI Codex CLI on: exploring an unfamiliar codebase, reviewing a plan/design .md, or reviewing a PR diff. Codex runs sandboxed read-only (no writes, no prompts, no network).
0 Updated 6 days ago
YoniChechik AI & Automation Featured
codex-exec
Run one caller-supplied Codex command non-interactively and capture evidence. Triggers: "run Codex headless", "capture Codex evidence".
429 Updated today
boshu2 Testing & QA Featured
real-e2e-test
Run real E2E tests against Claude CLI in pytest and tmux modes
3,113 Updated yesterday
liaohch3