LazyCodex Install Doctor
Audits your LazyCodex and Codex CLI installation against the latest upstream sources and returns an evidence-backed PASS/WARN/FAIL report.
UtilitiesIntermediate★ 67,531⑂ 5,507AI score 6/10Last updated: Aug 9, 2026
What it does
A diagnose-only health check for a local LazyCodex (omo-codex) and Codex CLI installation.
- Syncs the latest
lazycodexandopenai/codexsources into a temp source root and compares against real code instead of memory. - Inventories
codex --version,command -v codex, bin links,CODEX_HOME/config.toml, the plugin manifest (.codex-plugin/plugin.json), and declared runtime payload files. - Distinguishes expected install-time path rewrites (e.g. absolute
.mcp.jsonruntimes) from genuine drift. - Searches GitHub issues for each FAIL so known problems are linked rather than re-diagnosed.
- Emits a table-based PASS/WARN/FAIL report plus prioritized remediations.
Core rule: nothing is mutated during diagnosis. Writes are limited to the source cache directory, and fixes are applied only if you ask afterward.
Who it's for
- Developers actively using LazyCodex / omo-codex / Codex CLI.
- Anyone whose Codex setup started misbehaving after an install, update, or config change.
- Users suspecting a stale install, broken bin links, or missing plugin payload files.
Examples
- "Run a LazyCodex doctor check" → you get environment details, a six-row check table with evidence, and next actions.
- Hooks stopped firing after an update → the skill validates every manifest-declared hook path and points at the missing or zero-byte file.
- "Is my install drifted from latest?" → it compares installed vs. latest versions and reports only real drift, citing both local and upstream paths.
· · · Install guide · · ·
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 packages/omo-codex/plugin/components/lcx/skills/lcx-doctor folder from the GitHub repo code-yeongyu/oh-my-openagent into my ~/.claude/skills/lcx-doctor/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone --depth=1 https://github.com/code-yeongyu/oh-my-openagent.git /tmp/omo && mkdir -p ~/.claude/skills && cp -r /tmp/omo/packages/omo-codex/plugin/components/lcx/skills/lcx-doctor ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repository shallowly:
git clone --depth=1 https://github.com/code-yeongyu/oh-my-openagent.git /tmp/omo - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r /tmp/omo/packages/omo-codex/plugin/components/lcx/skills/lcx-doctor ~/.claude/skills/ - (Recommended) Make sure
gitand the GitHub CLI (gh) are installed and you've rungh auth login, since the skill clones upstream sources and searches issues. - Restart Claude Code, then ask something like "run a health check on my LazyCodex install" to trigger the skill.
View source on GitHub ↗License: NOASSERTION