Skip to main content
Run doctor after installation and when an authenticated request fails unexpectedly:
When credentials are present, the command checks the configured platform, public Market reachability, an authenticated executable-assets endpoint, and release information. Useful JSON fields include:
Missing configuration can produce structured guidance with healthy: false without treating the diagnostic command itself as a process error. Inspect the returned fields; do not rely only on the shell exit status.

​
When not to run doctor

For a local flag, file, JSON, workbook, or TemplateSpec validation error, fix the reported input first. Use doctor for authentication, endpoint, network, service-version, or unexpected server failures. Use --verbose only when needed:
Verbose logs go to stderr. Review them before sharing and never add tokens or request payloads. See Troubleshooting for recovery paths.