← ClaudeAtlas

codex-doctor-debuggerlisted

Diagnose current Codex CLI health and model-visible skill catalogs: metadata truncation/omission, install, config, auth, sandbox, prompt, app-server, remote-control, and runtime failures. For what an existing task saw, use codex-log-reader.
Xopoko/plug-n-skills · ★ 11 · AI & Automation · score 77
Install: claude install-skill Xopoko/plug-n-skills
# Codex Doctor And Debugger Bundled commands use `$PLUGIN_ROOT` (`$env:PLUGIN_ROOT` in PowerShell; same path suffix) for the plugin root. Set it once: use the host's plugin-root variable when defined (Claude Code: `PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"`), otherwise the absolute path of this plugin's root directory. Use this skill when Codex CLI itself is failing or unclear: installation, config, auth, runtime health, feature flags, sandbox denials, debug model catalog, app-server transports, remote-control daemon, remote connection errors, or local environment inconsistencies. If Codex starts normally, update-channel eligibility and freshness of a custom scheduled updater are outside this diagnostic lane. Inspect the updater that owns channel selection and use `scheduled-automation-runtime` to prove what its OS schedule actually ran. Return here only when Codex launch or runtime health itself is failing. ## Inspect First Start with cheap, non-mutating commands: ```bash python3 "$PLUGIN_ROOT/scripts/codex_cli_inspector.py" --commands doctor debug "debug prompt-input" sandbox features app-server remote-control --json codex doctor --summary --ascii ``` Use machine-readable doctor output when automation needs to classify issues: ```bash codex doctor --json ``` Do not paste raw doctor output into chat if it contains local paths, config fragments, or environment details that are not needed. Summarize issue names, counts, and actionable rows. ## Diagnostic Lanes ### Install,