What This Checks
tm auth whoami is a live Control Plane check. It calls the profile endpoint with the current bearer token and confirms that the token is accepted by the current Control Plane base URL.
Use tm auth status when you only need to inspect local credential presence without making a network call.
Usage
Examples
Show the current authenticated Control Plane identity.
Show the current authenticated Control Plane identity in structured JSON output.
Options
| Name | Type | Required | Default | Details |
|---|---|---|---|---|
--timeout | float | no | HTTP timeout in seconds for the profile call. |
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). | |||||
--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. | |||||
--gateway-provider | text | no | Inference Gateway provider for built-in host selection (nebius, lambda, yotta). |
Auth Scope
- controlplane-access-token
Prerequisites
- Run tm auth login first.
Caveats
- Uses
GET /auth/profileto live-validate the current bearer token.