Skip to main content

​
What This Checks

tm doctor is a broad local diagnosis command. It inspects configuration and credential readiness across the CLI, but it does not prove that a live API call will succeed. Use tm auth whoami for a live Control Plane auth check and tm infer chat for an end-to-end inference check.

​
Usage

tm doctor [OPTIONS]

​
Examples

​
Check the current CLI configuration and credential state.

tm doctor

​
Use shell-friendly exit codes when required credentials are missing.

tm doctor --exit-status

​
Options

NameTypeRequiredDefaultDetails
--exit-statusbooleannofalseExit non-zero when checks report a not-ready state. Boolean flag.

​
Inherited Global Options

NameTypeRequiredDefaultDetails
--version, -VbooleannofalseShow the version and exit. Boolean flag.
--configpathno"~/.config/tensormesh/config.toml"Path to config TOML file
--output`choice[textjsonyamlrawtable]`no"text"Output format (text is human-readable; json is machine-friendly).
--quietbooleannofalseSuppress non-essential output. Boolean flag.
--debugbooleannofalsePrint debug logs to stderr (secrets redacted). Boolean flag.
--ca-bundlepathnoPath to a PEM CA bundle for TLS verification (overrides TENSORMESH_CA_BUNDLE).
--timeoutfloatnoDefault HTTP timeout in seconds (overrides TENSORMESH_TIMEOUT_SECONDS; subcommands may override).
--max-retriesintegernoMax retries for idempotent HTTP requests on transient errors (overrides TENSORMESH_MAX_RETRIES; subcommands may override).
--controlplane-basetextnoOverride the Control Plane base URL.
--gateway-providertextnoInference Gateway provider for built-in host selection (nebius, lambda, yotta).

​
Caveats

  • Reports local readiness only. Use tm auth whoami to live-validate Control Plane auth and tm infer chat for an end-to-end inference check.
  • Use tm infer doctor for direct gateway gating and tm auth status/tm auth whoami for Control Plane-specific checks.

​
Parent Command