doctor

Usage

Claude: /rn-dev-agent:doctor
Codex:  $rn-dev-agent:doctor

What it reports

Codex doctor combines the package-local health executable with separate probes when the RN app root is known. It reports independent axes for:

• Codex host support (0.145.0 live-refresh floor; older hosts restart-only);
• exact plugin ID/version/enabled state;
• selected package materialization and all 28 skills/helpers;
• effective cdp registration;
• a side-effect-free MCP initialize/tools/list contract probe;
• direct and caller-observed proof_capture schema state;
• complete/partial caller-observed task skill and MCP inventories;
• prior observed transport/app status;
• linked-worktree action inheritance and repository-local hook status, without exposing private source paths or reading action bodies;
• learned-action compatibility (diagnose-actions): counts plus action ids for missing/low enginePin, regex text selectors, and unreadable actions, without printing YAML bodies or private inherit source paths. Any enginePin or regexSelector finding is FAIL even with a pinned-ok runner; YELLOW is allowed only when all findings are unreadable;
• all findings, a primary finding, and ordered recovery commands.

Unknown or partial task evidence is never classified stale. A direct contract probe is not represented as the active task transport or app state.

When the React Native app root is known, both hosts also run the packaged read-only session-doctor report probe and classify session-authority health as green, yellow (a proven-dead owner of this exact root, which the next transport start releases on its own), or red. A red report names the exact wedge — an owner whose process identity cannot be proven, a retained startupCleanupBlocked obligation, or an owner belonging to a different app root — instead of a generic stale-lock story. It names the supported repair command when recovery remains possible; managed-metro-stop-proof-missing is diagnostics-only and must be reported without running repair. Only a proven-dead owner is ever released; see recovering a wedged source root.

Strictly read-only

Doctor never installs, updates, removes, writes config/project/cache/state/log files, builds runners, attaches to an app/device, starts Observe, or kills/restarts a process. It prints commands for user confirmation. cdp_status is reserved for the active check-env workflow because it can attach.

A task that received zero rn-dev-agent skills cannot invoke doctor. Use the external exact-version cache bootstrap from Troubleshooting. /mcp verbose is inventory inspection only.

Main diagnoses

Missing/disabled installation, corrupt/version-mismatched materialization, missing/disabled MCP registration, contract-probe failure, explicit stale skill or MCP discovery, observed transport closure, server/host schema exposure, observed app disconnection, legacy restart requirement, healthy disk with unknown task state, and healthy.