tine pricing

Pricing commands are explicit catalog control-plane operations. Model inference never performs a network price lookup. To calculate a run's post-hoc price, use tine price.

Terminal

# Effective cards, with optional filters
tine pricing list --provider anthropic --model sonnet --at 2026-07-30

# Exact provider/model resolution
tine pricing show openai gpt-6.1-sol
tine pricing show google gemini-3.8-flash --json

# Verify a catalog; the bundled catalog is the default path
tine pricing check
tine pricing check ./catalog.json

# Install a signed catalog from a local file or direct HTTPS URL
tine pricing update ./catalog.json
tine pricing update https://trusted.example/catalog.json --dest ./pricing.json

Signature rules

check requires a valid signature by default. --allow-unsigned is for deliberate local overlays. Remote updates require HTTPS, do not follow redirects, are size-bounded, and must verify before installation.

Exact model matching

show resolves one provider/model pair for an effective date and fails when no exact card or alias exists. Unknown models remain runnable through adapters but stay visibly unpriced.

Overlay locations

Workspace .tine/pricing.json overrides the user catalog at $XDG_CONFIG_HOME/opentine/pricing.json, which overrides the bundled signed snapshot. Each overlay needs its own sha256:-prefixed catalog ID.

Time-of-day catalogs

opentine-pricing/2 adds optional ordered UTC schedules to a rate card. A window specifies half-open hour ranges, all, weekday, or weekend scope, and replacement rates for named dimensions. The first matching window wins. Cards without a schedule price exactly as before, and opentine-pricing/1 catalogs and overlays still load.

Catalog release boundary

The cards returned by list and show come from the installed /3 catalog; the v0.15 tagged snapshot has 231 cards. Current catalog signatures use the domain-separated v2 scheme and require v0.12 readers. Older signed workspace catalogs cannot roll back installed prices; different signed catalogs with the same generation timestamp are refused. Unsigned workspace overlays are announced on stderr; operator-controlled OPENTINE_TRUST_WORKSPACE_PRICING=1 suppresses that notice.

See usage and pricing for billing status, resolution order, streaming caveats, and strict-cost budgets.