Codex Plugin QA (codex-qa)

A QA harness that exercises the omo Codex plugin in a real codex app-server using an isolated CODEX_HOME and a local mock model, with hook firing proven by notifications.

Dev & CodingAdvanced★ 69,329⑂ 5,715AI score 7/10Last updated: Sep 23, 2026

What it does

Drives the packages/omo-codex (lazycodex) plugin through a real codex app-server while using a throwaway CODEX_HOME and a local mock model, so no real API call ever happens.
Proves a hook actually fired via the hook/started / hook/completed notification stream instead of scraping logs.
Installs the local build into the isolated home and asserts config.toml, component binaries, and agent TOMLs landed correctly.
Adds deterministic per-component hook probes, a tmux TUI smoke test, xterm.js web-terminal visual QA, and log observation paths (RUST_LOG, logs SQLite, /debug-config).
Shasums the real ~/.codex/config.toml before and after every run to prove the user's environment stayed untouched.
Enforces an evidence discipline: artifacts go under .omo/evidence/<date>-<slug>/, and no evidence file means the QA did not happen.

Who it's for

Contributors and maintainers changing packages/omo-codex in the oh-my-openagent repo.
Developers who need regression checks after touching Codex plugin hooks, components, or the installer.
Anyone studying a well-built isolated QA harness pattern that never pollutes the user's real config.

Examples

After editing hook logic, run scripts/hook-unit-probe.sh --self-test to pin exact stdout, then scripts/app-server-drive.sh --plugin to prove the live wiring.
After changing the installer or config.toml, run scripts/install-verify.sh --self-test to confirm the isolated-home install.
When the TUI path changes, run scripts/tui-smoke.sh --self-test for boot/render survival, and use the web-terminal QA script to produce true-color PNG/ANSI evidence.

· · · 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.

↓ Download 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 /tmp/oh-my-openagent && mkdir -p ~/.claude/skills && cp -r /tmp/oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal and clone the repo: git clone https://github.com/code-yeongyu/oh-my-openagent.git
Copy the skill folder into place: mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/
Install the prerequisites: codex (0.140.0+ recommended), node, jq, tmux, and bun.
Verify your CLI version: codex --version
Enter the skill folder and check the harness: cd ~/.claude/skills/codex-qa && bash scripts/lib/common.sh --self-check
Keep a checkout of the oh-my-openagent repo available, since the actual QA runs against that codebase.
Restart Claude Code and invoke it with phrases like "codex qa" or "verify codex hook".

View source on GitHub ↗License: NOASSERTION