Skip to content
Docs

rad doctor

Run the local checks after installation or when planning fails:

Terminal window
rad doctor
rad doctor --json

rad doctor checks manifests, lockfiles, supported languages, test runners, and missing setup. It does not modify the repository. Use --language when automatic detection selects the wrong workspace or the repository contains multiple languages.

Fix each reported problem in the project itself. For example, installing Vitest is not enough if the project’s tests use another runner.

Local doctor and hosted doctor answer different questions:

  • rad doctor checks whether the local repository can be planned.
  • rad remote doctor checks the API token, repository access, CLI and server compatibility, supported languages, and upload limits.

Run both before contacting support about a hosted failure. Include their JSON output after removing secrets and private paths.