doctor - OMX Installation Diagnostics Tool
Diagnose and fix oh-my-codex installation issues
Tags
Updated: 2026-05-28Typical Outputs
What this skill does
- check plugin version
- verify hook configuration
- detect legacy scripts
- validate AGENTS.md
- inspect plugin cache
- identify legacy agents
- identify legacy commands
- check skill directories
- generate diagnostic report
- apply automatic fixes
- remove legacy hooks
- clear plugin cache
- update configuration files
Inputs
- CODEX_HOME environment variable
- plugin cache directory
- config.toml file
- settings.json file
- AGENTS.md file
- ~/.codex/hooks/ directory
- ~/.codex/agents/ directory
- ~/.codex/commands/ directory
- ~/.codex/skills/ directory
- ~/.agents/skills/ directory
Outputs
- diagnostic report
- health status
- issue descriptions
- recommended fixes
- fixes applied confirmation
Requirements
- Codex CLI environment
- npm access
- GitHub access
- file system access
- write permissions
- bash shell
