LazyCodex Install Doctor
A read-only health check that audits your LazyCodex and Codex CLI install against the latest upstream sources and returns an evidence-backed PASS/WARN/FAIL report.
UtilitiesAdvanced★ 67,531⑂ 5,507AI score 7/10Last updated: Aug 9, 2026
What it does
- Shallow-clones the latest LazyCodex and openai/codex sources into a temp source root, then compares your local install against real code rather than remembered layout.
- Inventories the installed surface:
codex --version,command -v codex,CODEX_HOME, plugin manifest (.codex-plugin/plugin.json),config.toml, bin links, and.mcp.jsonruntimes. - Produces a six-row check table (version currency, config integrity, plugin payload wiring, bin links, runtime probe, drift vs latest source) where every verdict must cite command output or a file path.
- Searches
gh issue listfor known issues behind each FAIL, and proposes remediations while never mutating your config, install, or repos during diagnosis (writes are confined to the source cache).
Who it's for
- Users running the LazyCodex (lazycodex-ai / omo-codex) plugin for Codex CLI.
- Anyone whose Codex behaves oddly after an install, update, or config change.
- Anyone suspecting a stale or drifted setup who wants an audit against the latest release.
Examples
- "Run a doctor check on my LazyCodex install" → you get environment details, the six-check verdict table, and prioritized fixes.
- Hooks stopped loading after an update → it validates only the hook paths the current manifest declares, ignoring retired paths, and FAILs only on missing or zero-byte targets.
- Leftover project-local
.codex/hooks.jsonfound → it flags rather than deletes, and offers a cleanup command only if you ask afterward.
· · · 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/packages/omo-codex/plugin/components/lcx/skills/lcx-doctor/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 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 /tmp/oh-my-openagent && mkdir -p ~/.claude/skills && cp -r /tmp/oh-my-openagent/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.
- Shallow-clone the repo:
git clone --depth=1 https://github.com/code-yeongyu/oh-my-openagent /tmp/oh-my-openagent - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill folder:
cp -r /tmp/oh-my-openagent/packages/omo-codex/plugin/components/lcx/skills/lcx-doctor ~/.claude/skills/ - Make sure
gitand the GitHub CLI (gh) are installed and that you've rungh auth login(used for source clones and issue search). - Restart Claude Code, then ask something like "health-check my LazyCodex install" to trigger the skill.
View source on GitHub ↗License: NOASSERTION