Skip to content

omo-kit doctor

Config health checker. Scans your OMO and OpenCode config files for errors, warnings, and stale references.

Usage

bash
bunx omo-kit doctor

What it checks

CheckSeverity
JSON syntax validityError
provider vs providers keyError
Non-existent theme namesWarning
Legacy oh-my-opencode.json filenameWarning
Missing required keys in agent configError
Broken/aspirational repo referencesWarning

Example output

$ bunx omo-kit doctor

~/.config/opencode/opencode.json ........... ✓ OK
~/.config/opencode/oh-my-openagent.json .... ✓ OK
~/.config/opencode/tui.json ................ ✓ OK

./opencode.json ............................ ✓ OK
./oh-my-openagent.json ..................... ⚠ WARN
  → Line 12: agent "librarian" has no fallback_models
./CLAUDE.md ................................ ✓ OK
./AGENTS.md ................................ ✓ OK

1 warning found. Configs usable but could be improved.

Exit codes

  • 0 — All clean
  • 1 — Errors or warnings found

Built with VitePress. Contribute on GitHub.