Use diagnostics when a command fails and you need to separate local profile problems from node problems.
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
These commands emit JSON and are useful for scripts and health probes.
Shell completions
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
tc doctor is the fastest way to tell whether a failure is local state, auth state, or node reachability.