Skip to main content

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

Examples

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

Inspect serverless readiness before the first request.

Inspect local Control Plane and inference auth state.

Send a basic serverless chat request.

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 cost: Per-model serverless spend and KV-cache savings.
  • 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

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”}]’