> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogfoundry.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Doctor

> Diagnose LoomLoom configuration, connectivity, authentication, and release state.

Run `doctor` after installation and when an authenticated request fails unexpectedly:

```bash theme={null}
loomloom doctor --output json
```

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:

| Field                  | Meaning                                                       |
| ---------------------- | ------------------------------------------------------------- |
| `server`               | Resolved base URL                                             |
| `token_set`            | Whether a token is configured; the token value is not printed |
| `platform`             | Platform inferred or selected for the request                 |
| `platform_operational` | Whether that platform is enabled for current flows            |
| `healthy`              | Whether the connectivity and authentication checks succeeded  |
| `credential_action`    | Setup action needed when credentials are incomplete           |
| `cli_version`          | Installed CLI version                                         |
| `release_channel`      | Installed release channel                                     |
| `update_available`     | Whether a newer release was detected                          |

<Note>
  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.
</Note>

## 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:

```bash theme={null}
loomloom doctor --output json --verbose
```

Verbose logs go to stderr. Review them before sharing and never add tokens or request payloads. See [Troubleshooting](/developer-reference/loomloom-cli/troubleshooting) for recovery paths.