doctor¶

Diagnose the AutoShip environment and dependencies.

Syntax¶

autoship doctor [OPTIONS]

doctor does not accept positional arguments.

Short	Long	Default	Description
-	`--json`	`False`	Output report as JSON
-	`--fail-on-error`	`False`	Exit with non-zero code when errors are present

Run a health check:

autoship doctor

Structured output for CI:

autoship doctor --json

Fail the pipeline on errors:

autoship doctor --fail-on-error

Checks include Python version, Git configuration, model backend connectivity, clean toolchain, plugin external dependencies, and audit/telemetry directory permissions.
Results are graded OK / WARNING / ERROR. A missing local model backend is reported as WARNING and does not affect non-AI commands.
doctor respects project_type to skip irrelevant tool checks. Non-Python projects skip autoflake / black checks, avoiding unrelated ERROR or WARNING items.