Usage and costs

Use /usage to check token counts and costs recorded by fx on this machine. For billed usage, check your provider dashboard.

Inspect local usage

From your terminal, show usage for the last 30 days:

$fx usage

Choose a period or return structured output:

$fx usage --period 24h --json

Periods are 24h, 7d, and 30d. Reports include requests, tokens, spend, and a breakdown by model. In fx, /usage also lets you view the current session.

A partial window means tracking started during the selected period. Pending totals exclude requests awaiting usage data from Gateway. Incomplete totals are missing some usage data.

Account billing

Local reports cover this fx profile on this machine. Other devices and applications using the same account are excluded.

For billed usage and subscription limits, check your provider's dashboard. Missing cost information in fx does not mean a request was free.

Ultrafast pricing

Ultrafast is an explicit opt-in to a higher-priced OpenAI tier through AI Gateway. Check the selected model's current pricing before enabling it. Main-agent and eligible subagent requests can both use the tier.

The footer's single yellow lightning marker and ultrafast_requested report what fx requested, not a billing guarantee. When Gateway does not confirm that it served Ultrafast, fx warns that the response may have used a standard or lower tier. Check Gateway's billed usage for the charge; missing confirmation does not mean the request was free.

Session titles, permission reviews, and context compaction do not inherit Ultrafast.

Additional model requests

These features can make requests in addition to the main conversation:

FeatureWhen it runs
Auto modeA tool action needs a model review.
SubagentsEach subagent makes its own model requests.
Vision fallbackAI Gateway analyzes images for a model without image input.
Context compactionfx summarizes older context automatically or through /compact.
Session titlesfx generates a title from the first prompt.

Title requests are excluded from session usage totals. Turn them off with session_titles: false in your profile or through /settings.

Web search can also add provider charges.

Check your AI Gateway balance

With AI Gateway selected, check the balance for the active credential:

$fx credits

For billing details, open your AI Gateway dashboard.