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.
When To Use This
Usetm cost to see what you spent and what KV caching saved you, without configuring a separate cost-tracking proxy. Spend comes from BillingTransaction.details (populated by the billing service at charge time, so it reconciles with the ledger). Cache savings is cached_tokens x input rate — what those tokens would have cost at full price, served at ~$0 by the cache.
Cache savings is always computed over the exact window. Per-model dollar spend is calendar-month granular (one serverless transaction per user per month): --month YYYY-MM is exact, while --window 24h|7d|30d and --start/--end report the overlapping monthly spend (noted in the output).
Usage
Examples
Last 30-day spend + cache savings, per model.
Last 7-day total (per-model defaults to current month).
Exact calendar-month spend + savings for May 2026.
Exact-window spend + cache savings.
Machine-friendly JSON for piping into other tools.
Details
Show per-model serverless spend and KV-cache savings. Spend comes fromBillingTransaction.details (authoritative, reconciles
with the ledger; calendar-month granularity). Cache savings is computed as
cached_tokens x input rate — the cost those tokens would have incurred at
full input price, served at ~$0 thanks to caching — with cached tokens read
from the serverless usage history for the exact window.
Every view shows the same shape: a per-model table plus the serverless
subtotal and total cache saved. --window 24h|7d|30d (rolling),
--month YYYY-MM (exact calendar month), and --start/--end (exact range)
just change the window. Cache savings is always window-exact; per-model
dollar spend is calendar-month granular (the finest the ledger records), so
every view except --month notes that.
Options
| Name | Type | Required | Default | Details | ||
|---|---|---|---|---|---|---|
--user-id | text | no | Optional user id to scope the report (defaults to the authenticated user). | |||
--window | `choice[24h | 7d | 30d]` | no | "30d" | Rolling window for the report (mutually exclusive with —month and —start/—end). |
--month | text | no | Per-model spend + savings for a specific calendar month (YYYY-MM), aligned with how serverless transactions are aggregated. | |||
--start | text | no | Arbitrary window start (ISO 8601). With —end, reports per-model spend + cache savings for an exact range (savings is window-exact; per-model dollar spend comes from the overlapping monthly transactions). | |||
--end | text | no | Arbitrary window end (ISO 8601); defaults to now when —start is given. | |||
--timeout | float | no | HTTP timeout in seconds. |
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. |