# axx doctor

> Check that this project and machine are ready to run Axx

Source: https://axx.nimbusxr.us/references/cli/axx-doctor/

Check the Axx installation, axx.yaml, feature files, step definitions
and the commands your apps need. Agents: run this first in a new repo.

Exit code 0 when nothing failed (warnings allowed), 4 otherwise.

```text
Usage:
  axx doctor [flags]

Flags:
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
  -h, --help                 help for doctor
      --profile string       apply profiles.<name> / axx.<name>.yaml (env: AXX_PROFILE)

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)
```