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

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# atlanai doctor

> Check local paths, installation, credentials, runtime, and daemon state.

`doctor` is the first diagnostic command to run. It works offline and does not
contact the Gateway.

## Usage

```text theme={null}
atlanai doctor [flags]
```

The command accepts no positional arguments.

## Options

| Option | Type | Default | Description |
| - | - | - | - |
| `--json` | string list | none | Select `command`, `config`, `crashReports`, `daemon`, `gateway`, `installLog`, `runtime`, `state`, `telemetry`, `tokenSource`, or `versions`. |
| `--jq`, `-q` | string | none | Filter JSON output with jq. |
| `--template`, `-t` | string | none | Render JSON data with a Go template. |

## Examples

```bash theme={null}
atlanai doctor
atlanai doctor --json command,gateway,tokenSource,daemon
```

## Output and behavior

* Reports when another `atlanai` on `PATH` shadows this installation.
* Shows local config, state, runtime, version, and install-log paths.
* Identifies the configured Gateway and credential source without printing a
  token.
* Reports telemetry, crash-report, and daemon state.
* Notes a legacy installation without reading or changing it.

## Related

* [Diagnose the CLI](/tools/cli/troubleshooting/diagnostics)
* [`atlanai version`](/tools/cli/references/commands/version)
* [`atlanai auth`](/tools/cli/references/commands/auth)
* [`atlanai logs`](/tools/cli/references/commands/logs)