Codex QA (omo Codex Light verification)
QA the omo Codex plugin in a fully isolated CODEX_HOME with a mock model, proving hooks actually fire without ever touching the user's real ~/.codex.
Dev & CodingAdvanced★ 69,295⑂ 5,711AI score 8/10Last updated: Sep 22, 2026
What it does
- Exercises the
packages/omo-codex(lazycodex) plugin against a realcodexbinary but inside an isolatedCODEX_HOMEwith a local mock model provider — no real API calls, and the user's~/.codexis never read or written. - Proves a hook fired the first-party way: via
codex app-serverhook/started/hook/completednotifications instead of scraping logs. - Provides a router table matching QA path to change scope: component hook probes (
hook-unit-probe.sh), installer/config.tomlchecks (install-verify.sh), live session drive (app-server-drive.sh --plugin), and a tmux TUI smoke test (tui-smoke.sh). - Every helper script ships a
--self-test, doubling as its own regression check, and shasums~/.codex/config.tomlbefore/after to prove the real home stayed clean. - Forces evidence capture into
.omo/evidence/<date>-<slug>/— no artifact means the QA did not happen.
Who it's for
- Contributors and maintainers of the oh-my-openagent repo working on
packages/omo-codex. - Developers who changed Codex plugin hooks, components, or the installer and need regression proof.
- Anyone looking for a solid pattern for safely QA-ing a CLI plugin without polluting personal config.
Examples
- After editing hook logic: run
scripts/hook-unit-probe.sh --self-testto pin theultraworkcomponent's exact stdout, thenscripts/app-server-drive.sh --pluginto prove the live wiring emitshook/completed. - After touching the installer:
scripts/install-verify.sh --self-testconfirmsomo@sisyphuslabsis enabled in the isolatedconfig.tomland component binaries/agent TOMLs are linked. - When TUI visual evidence is needed:
tui-smoke.shverifies the TUI boots and survives, thenweb-terminal-visual-qa.mjsrenders it through xterm.js for true-color screenshots without tmux's color/CJK degradation.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/.agents/skills/codex-qa/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .agents/skills/codex-qa folder from the GitHub repo code-yeongyu/oh-my-openagent into my ~/.claude/skills/codex-qa/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Install prerequisites:
node,jq,tmux,bun, and thecodexCLI (verified against 0.140.0). Check withcodex --version. - Clone the repo:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - Copy the skill:
mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/ - Restart Claude Code and confirm the skill is picked up (try a prompt like "codex qa").
- Before the first run, from the skill directory execute
bash scripts/lib/common.sh --self-checkto validate dependencies and the isolation harness. - Run the actual QA from inside the oh-my-openagent working tree; prefer the Docker surface via
script/agent/qa-docker.shwhen available. - Store outputs under
.omo/evidence/<date>-<slug>/and verify the script output asserting your real~/.codexis unchanged.
View source on GitHub ↗License: NOASSERTION