Skip to main content

locopilot usage

Show token usage and estimated cost for the current period.

Source: src/cli/commands/usage.ts

Synopsis

locopilot usage

No flags. Requires a Pro token (locopilot login).

Output

Period: 5/1/2026 → 6/1/2026
Tokens: 1,283,447
Requests: 3,981
Cost: $12.4567 (estimated)

Backed by GET /api/usage on LocoPilot Cloud, which aggregates the usage_events table for the current Stripe billing period.

What's counted

  • Tokens — sum of tokens_in + tokens_out from completed inference calls that used remote GPU. Local-only (Ollama-served) requests are not counted.
  • Requests — total number of /api/inference calls billed to your account.
  • Costtokens × provider_rate for each row in usage_events. The figure is estimated; final invoices come from Stripe at period end.

Not logged in

Not logged in.
Run: locopilot login

Exits 0 — usage requires Pro context, but the absence of a token is not an error.

Errors

ErrorCause
✖ Token rejected by cloud.Token revoked — log in again
✖ /api/usage returned 5xx.Cloud outage
✖ Network error: …Local connectivity issue