# Usage & costs

> See exactly how many tokens your agents use and what they cost — by agent, workspace, agent type, model and provider.

Source: https://docs.neurosquad.ai/en/usage

AI agents are paid by the token. The **Usage** section in the sidebar shows where your tokens — and
your money — go.

## Pick a period

Choose **Today**, **7 days**, **30 days**, **This month**, **Last month** or **All time**, or any
**Date range** you like. Every number is compared with the previous period of the same length.
Narrow it down to one workspace or one agent with the filters. **Include usage outside cards** also
counts sessions you ran in your own terminal, outside NeuroSquad.

## What you see

- **Tokens and cost** for the period, at the top.
- **Tokens over time**, stacked by agent, and **What the tokens were** — new input, context re-read
from cache, context written to cache, output.
- **When the tokens go out** — a weekday × hour map of when your agents are busiest.
- **Every agent** — a sortable table with the exact numbers: requests, input, cache, output, total,
peak context, cost and share.

Breakdown tabs split the same numbers **By agent**, **By workspace**, **By harness**, **By model** and
**By provider**. Click an agent or workspace to jump to it.

## Compare models

**Compare models** puts several models side by side: cost, tokens, cost per request, cost per 1,000
output tokens, share of the period, and each model's list price.

## Exact numbers, and where they come from

Costs are counted exactly and only rounded on screen. The rows always add up to the total. Each cost
is either what the agent program itself recorded, or the model's list price — and requests sent
through [OpenRouter](https://docs.neurosquad.ai/en/providers/openrouter) are priced from OpenRouter's own catalogue. A model with no known price — one on [your own server](https://docs.neurosquad.ai/en/providers/your-servers), say — shows **no price**, never $0, and a number the agent's log doesn't carry (a local server often sends no cache counts) shows as **not reported**, not 0.

> Usage is read from the agents' own logs: **Claude Code**, **Codex CLI**, **OpenCode**, **Kilo Code**, **Hermes Agent**, **Pi** and
> **omp**. The section tells you which of your agents aren't counted. If you're on a subscription
> rather than paying per token, the cost shown is what the same work would cost at list price.

## Export

**Export CSV** saves the table, to open in Excel or Google Sheets.

## OpenRouter

If you use [OpenRouter](https://docs.neurosquad.ai/en/providers/openrouter), the **By provider** tab shows what OpenRouter reports
for your key: spent today, this week, this month and all time, and your limit. That's for the key as
a whole — every agent and every other app that uses it.

## Keep costs under control

- The agent card shows how full a Claude Code, OpenCode, Kilo Code or Hermes Agent agent's context is.
- A [Budget card](https://docs.neurosquad.ai/en/cards/budget) sets a token limit for a whole workspace and pauses its agents when
it's crossed.
