What This Checks
tm auth status is a local readiness check. It inspects whether the expected Control Plane and gateway credentials are present locally. It does not make a live API request.
Use tm auth whoami when you want to verify that the current bearer token works against the Control Plane.
Usage
Examples
Show local Control Plane and Gateway auth state.
Use shell-friendly exit codes when Control Plane or Gateway auth is not ready.
Options
| Name | Type | Required | Default | Details |
|---|---|---|---|---|
--exit-status | boolean | no | false | Exit non-zero when Control Plane or Gateway auth prerequisites are missing. Boolean flag. |
Inherited Global Options
| Name | Type | Required | Default | Details | ||||
|---|---|---|---|---|---|---|---|---|
--version, -V | boolean | no | false | Show the version and exit. Boolean flag. | ||||
--config | path | no | "~/.config/tensormesh/config.toml" | Path to config TOML file | ||||
--output | `choice[text | json | yaml | raw | table]` | no | "text" | Output format (text is human-readable; json is machine-friendly). |
--quiet | boolean | no | false | Suppress non-essential output. Boolean flag. | ||||
--debug | boolean | no | false | Print debug logs to stderr (secrets redacted). Boolean flag. | ||||
--ca-bundle | path | no | Path to a PEM CA bundle for TLS verification (overrides TENSORMESH_CA_BUNDLE). | |||||
--timeout | float | no | Default HTTP timeout in seconds (overrides TENSORMESH_TIMEOUT_SECONDS; subcommands may override). | |||||
--max-retries | integer | no | Max retries for idempotent HTTP requests on transient errors (overrides TENSORMESH_MAX_RETRIES; subcommands may override). | |||||
--controlplane-base | text | no | Override the Control Plane base URL. |
Prerequisites
- Set
gateway_api_keyunder[overrides]inconfig.tomlsotm auth statusreports the inference API key as present.
Caveats
- Reports local credential presence. Use
tm auth whoamito live-validate Control Plane auth.