axon doctor

Report what is wrong with the current project's installed state.

axon doctor

It repairs nothing. It prints faults and exits, leaving the fix to you — usually axon prepare.

It exists because "my install is broken" used to be a debugging session. The faults it names were each found once in production, from an error message that pointed somewhere else: a dangling cache graft reported as a missing cognet, a staging-resolved version range reported as a typo. Each of those cost an afternoon, and each is now one line of output.

doctor reads the same primitive prepare gates on, so the two can never disagree. A diagnostic that contradicts the tool it diagnoses is worse than no diagnostic at all.

axon doctor --json

Reach for it when a project will not boot, when an installed module is not appearing in the tool manifest, or when an error message does not match what you know about the project.