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

# Diagnostics

> Run health checks and inspect node reachability

Use diagnostics when a command fails and you need to separate local profile problems from node problems.

## `tc doctor`

```bash theme={null}
tc doctor
```

`tc doctor` checks:

* Node.js version
* Profile existence
* Local key presence
* Session presence
* Node reachability
* Hosted space presence

It prints a human-readable checklist by default and JSON with `--json`.

## `tc node`

```bash theme={null}
tc node health
tc node version
tc node status
```

These commands emit JSON and are useful for scripts and health probes.

## Shell completions

```bash theme={null}
tc completion bash
tc completion zsh
tc completion fish
```

## When a check fails

* No profile or no key: run `tc init`
* No session: run `tc auth login`
* No space: run `tc space create <name>`
* Node unreachable: confirm the node URL and network access

<Tip>
  `tc doctor` is the fastest way to tell whether a failure is local state, auth state, or node reachability.
</Tip>