Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tensormesh.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Before You Use tm

  • Install the CLI first if tm is not already on your PATH. In this repo checkout, use ./.venv/bin/tm until your shell already exposes tm.
  • Start with tm init if you are not sure what is already configured locally.
  • Use tm auth login to obtain a Control Plane bearer token.
  • Put global options such as --output json before the subcommand.
  • Set TM_CONFIG_HOME when you need an alternate config and auth root for local scripting.
  • Use tm auth status, tm infer doctor, and tm doctor for local readiness checks.
  • Use tm auth whoami for a live Control Plane auth check and tm infer chat for an end-to-end inference check.

​
Usage

tm [OPTIONS] COMMAND [ARGS]...

​
Examples

​
Inspect local setup and print the shortest path to a working request.

tm init

​
Inspect serverless readiness before the first request.

tm infer doctor

​
Inspect local Control Plane and inference auth state.

tm auth status

​
Send a basic serverless chat request.

tm infer chat --api-key YOUR_INFERENCE_API_KEY --model YOUR_SERVERLESS_MODEL_NAME --json '[{"role":"user","content":"hi"}]'

​
Details

Tensormesh CLI for Control Plane and Inference API workflows.

​
Subcommands

  • tm activities: Activities (Control Plane).
  • tm admin: Admin-only commands (Control Plane).
  • tm auth: Authenticate to the Tensormesh Control Plane.
  • tm billing: Billing and usage (Control Plane).
  • tm completion: Print a shell completion script for Bash/Zsh/Fish.
  • tm config: Manage Tensormesh CLI configuration.
  • tm doctor: Diagnose configuration and credentials.
  • tm infer: Inference commands for the OpenAI-compatible serverless endpoints.
  • tm init: Guide first-time CLI setup for Control Plane and serverless workflows.
  • tm metrics: Observability metrics (Control Plane).
  • tm products: Products (Control Plane).
  • tm reserved-deployments: Reserved deployments (Support; Control Plane).
  • tm tickets: Support tickets (Control Plane).
  • tm users: User profile resources (Control Plane).
  • tm version: Show CLI version and runtime details.

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

​
Environment Variables

  • TENSORMESH_CA_BUNDLE
  • TENSORMESH_TIMEOUT_SECONDS
  • TENSORMESH_MAX_RETRIES
  • TM_CONFIG_HOME

​
Additional Notes

Config precedence: flags > env > config.toml ([overrides] before [managed]) > defaults. Global options such as —output must come before the subcommand: tm —output json auth status gateway_api_key in config.toml stores the inference API key used by serverless requests. Set it under [overrides] in config.toml, or pass —api-key on each request. It has no environment-variable equivalent. Control Plane auth uses auth.json under the active state root. Quickstart: tm auth login tm auth status tm infer chat —api-key YOUR_INFERENCE_API_KEY —model YOUR_SERVERLESS_MODEL_NAME
—json ’[{“role”:“user”,“content”:“hi”}]’