code-yeongyu/oh-my-openagent / .agents/skills/codex-qa
codex-qa
VerifiedQA the omo Codex Light edition (lazycodex / packages/omo-codex) itself, in strict isolation so ONLY our plugin is exercised, never the user's real ~/.codex. The first-party method drives the real `codex app-server` against an isolated CODEX_HOME plus a LOCAL mock model (no real API call), and proves a plugin hook fired by asserting hook/started + hook/completed notifications. Also: isolated install verification, per-component hook probes, a tmux TUI smoke, and runtime log observation (RUST_LOG / logs SQLite / /debug-config). Ships tested helper scripts each with a --self-test. Use whenever someone changes anything under packages/omo-codex or wants to QA, smoke-test, verify, or debug the Codex plugin, its hooks/components, the installer/config.toml, the app-server flow, or the Codex TUI. Triggers: codex qa, qa codex, codex-qa, test codex plugin, verify codex hook, codex app-server, lazycodex qa, isolated CODEX_HOME, prove codex hook fired, codex tui test.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.6 KB |
| references/app-server.md | markdown | 3.0 KB |
| references/components-hooks.md | markdown | 2.7 KB |
| references/docker-qa.md | markdown | 2.6 KB |
| references/install-verify.md | markdown | 2.6 KB |
| references/isolation.md | markdown | 2.5 KB |
| references/logging-debug.md | markdown | 2.6 KB |
| scripts/app-server-drive.shexecutable | script | 3.1 KB |
| scripts/hook-unit-probe.shexecutable | script | 3.0 KB |
| scripts/install-verify.shexecutable | script | 2.5 KB |
| scripts/lib/app-server-client.mjs | script | 6.3 KB |
| scripts/lib/app-server-client.test.js | script | 1.9 KB |
| scripts/lib/common.shexecutable | script | 7.1 KB |
| scripts/lib/mock-model.mjs | script | 2.1 KB |
| scripts/lsp-e2e.shexecutable | script | 150.9 KB |
| scripts/tui-smoke.shexecutable | script | 2.9 KB |
references/install-verify.md
View on GitHub# Installing the LOCAL omo build into an isolated CODEX_HOME
QA must run THIS repo's local build, not the published package. The installer
respects `CODEX_HOME` for everything, so a non-default home is fully self
contained.
## Command
```bash
export CODEX_HOME="$(mktemp -d)/codex"; mkdir -p "$CODEX_HOME" # must exist first
export OMO_DISABLE_POSTHOG=1 OMO_CODEX_DISABLE_POSTHOG=1
export OMO_CODEX_PROJECT="$(mktemp -d)/project" # keep project-local cleanup off your tree
node packages/omo-codex/scripts/install-local.mjs install
```
`cqa_install_local_omo` wraps this (logs to `$CQA_HOME_ROOT/install.log`).
## What it writes (all under CODEX_HOME)
Source: `packages/omo-codex/src/install/install-codex.ts`.
1. Builds + copies the plugin to
`$CODEX_HOME/plugins/cache/sisyphuslabs/omo/<version>/` (then `npm ci --omit=dev`).
2. Links component bins into `$CODEX_HOME/bin/omo-*` (8: comment-checker,
git-bash-hook, lsp, rules, start-work-continuation, telemetry, ultrawork,
ulw-loop).
3. Links agent TOMLs into `$CODEX_HOME/agents/*.toml`.
4. Writes a marketplace snapshot under `$CODEX_HOME/.tmp/marketplaces/sisyphuslabs/`.
5. Edits `$CODEX_HOME/config.toml`: enables `[plugins."omo@sisyphuslabs"]`,
the `[marketplaces.sisyphuslabs]` local source, `[features]`
(plugins/plugin_hooks/multi_agent/child_agents_md), and one
`[hooks.state."omo@sisyphuslabs:hooks/hooks.json:<event>:i:j"] trusted_hash`
per hook (so Codex trusts them — no `--dangerously-bypass-hook-trust` needed
for the app-server turn).
## Assertions (what install-verify.sh checks)
```bash
ls "$CODEX_HOME"/plugins/cache/sisyphuslabs/omo/*/ # cache present
grep -A2 '\[plugins."omo@sisyphuslabs"\]' "$CODEX_HOME/config.toml" | grep 'enabled = true'
ls "$CODEX_HOME"/bin/omo-* # component bins
ls "$CODEX_HOME"/agents/*.toml # agent links
```
Plus the cross-cutting invariant every script enforces: the real
`~/.codex/config.toml` shasum is unchanged.
## Notes
- The only thing outside CODEX_HOME is the `omo` runtime wrapper, which targets
the repo's `dist/cli/index.js` (the CLI ships from the repo). `dist/cli/index.js`
must exist (run `bun run build` if missing) or that link is skipped.
- Cleanup: for an isolated home just `rm -rf "$CODEX_HOME"` (the harness does
this on exit). For a normal home, `node packages/omo-codex/scripts/install-local.mjs uninstall`.
- `bun run test:codex` is the hermetic unit gate (installer/config/component
build) and does NOT launch a real codex — this skill is what proves the live
session.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |