Skip to main content
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

​
Exit codes and error output

When stdout is not a terminal, errors go to stderr as { "error": { "code", "message", "hint" } }. CLI 1.1.0 beta also does this for --json at a terminal. Branch on error.code; the exit status groups related codes. tc share has its own codes, including 8 and 9; see Share files.

​
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.