# Usage dashboard

> Where to read what your agents have spent — total tokens, which models and which agents spent them, how much of your plan allowance is left, and the usage of a single conversation.

The **usage dashboard** is the record of what your agents have spent: tokens, over time, broken down by model and by agent.

## When to use it

Open it when the token badge on the [Activity](/docs/work/activity/) board is higher than you expected, before changing the model on a [routine](/docs/automate/routines/), or at the start of a week to see where last week went.

For *what* consumes usage and how the allowance works, read [Plans and usage](/docs/account/plans-and-usage/) first. This page is about reading the numbers.

## Getting there

<Steps>

1. **Open the Usage tab** on the home screen, or select the token badge in the Activity header.

2. **Pick a period.** 7 days, 30 days, or 3 months. The period changes the tiles and the charts; the yearly activity map always covers the current year.

3. **Move between the four tabs** — Overview, Models, Agents, Compute.

</Steps>

## Overview

The tiles across the top answer "how much, how often, and with what":

| Tile | Reads |
| --- | --- |
| **Total Tokens** | Everything sent and received in the period |
| **Requests** | How many model calls that took |
| **Active Days** | Days in the period with any usage |
| **Current Streak** | Consecutive days of usage, with your longest as a hint |
| **Top Model** | The model that accounted for the most tokens |
| **Usage Credits** | This week's spend in credits. The tile names the ratio it uses |

Below them, **Plan Allowance** is the one to watch: a bar showing how much of the current allowance is gone, and a plain statement when it is exhausted. This is the same number the service checks before it starts a [run](/docs/work/runs/), so when the bar is full, runs stop.

**Daily Activity** is a year-long map, one square per day, darker where you used more. It is the fastest way to spot a routine that started spending every day without you noticing.

## Models and Agents

Both tabs have the same shape: a daily chart on top, a breakdown below.

- **Models** — which models the tokens went to. This is the biggest lever on cost, so this is where a decision to switch a model usually starts. See [Choosing a model](/docs/build/models/).
- **Agents** — which agents did the spending, and which models each one used. A routine-heavy agent shows up here long before you notice it anywhere else.

In both, the legend is a filter: turn a series off to read the rest without it, and **Show All** brings them back. Rows the chart does not have room for are collected into an "other" entry rather than dropped.

<Aside type="note" title="'Unassigned' is not a bug">
  The Agents tab has an **Unassigned** row for usage that is not attributable to
  one agent — account-level calls. It is real spend with no agent to hang
  it on.
</Aside>

## Compute

Browser sessions, workspace storage, media processing, and artifact storage are listed here but **not yet measured**. The tab says so on every row.

Read the empty rows as "not instrumented yet", not as "zero". Nothing on this tab is a claim that a resource is free.

## Usage for one conversation

The dashboard is per account. For a single thread, type **`/usage`** in that conversation's composer: a card shows input and output tokens, how many were cached, the weighted total, credits, and the models involved, with a link into the dashboard.

That card is a local view, not a message — it does not appear in the transcript, and it is gone after a reload.

<Aside type="note" title="Two different numbers, both correct">
  The `/usage` card counts what the conversation has *spent so far*. The
  [context window](/docs/work/context-window/) panel counts what is *loaded into the
  model right now*. They are different axes and will not match.
</Aside>

## Limits

- Usage is metered per account. The per-agent view is a breakdown of the same total, not a separate allowance.
- Figures settle shortly after a run, so the newest run can be missing for a short while.
- Runs made with [your own key](/docs/account/bring-your-own-key/) are not recorded here. A conversation that used only your own key reads as "no usage recorded" — which is accurate for Endue's ledger and says nothing about what your provider billed you.
- Per-agent aggregation is not available in every environment. When it is not, the tab says so rather than showing zero.
- The Compute tab is a list of resources, not a measurement.

## Related

<CardGrid>
  <LinkCard
    title="Plans and usage"
    href="/docs/account/plans-and-usage/"
    description="What consumes the allowance, and how the weekly window works."
  />
  <LinkCard
    title="Choosing a model"
    href="/docs/build/models/"
    description="The decision the Models tab exists to inform."
  />
  <LinkCard
    title="Bring your own key"
    href="/docs/account/bring-your-own-key/"
    description="Why some runs never appear here."
  />
  <LinkCard
    title="Activity"
    href="/docs/work/activity/"
    description="The board whose token badge links here."
  />
</CardGrid>
