> ## Documentation Index
> Fetch the complete documentation index at: https://docs.castari.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cast usage

> View usage statistics

# cast usage

Show usage statistics for your Castari account.

## Usage

```bash theme={null}
cast usage [--days <days>] [--daily]
```

## Options

| Option              | Description                             | Default |
| ------------------- | --------------------------------------- | ------- |
| `-d, --days <days>` | Number of days to show                  | `30`    |
| `--daily`           | Show daily breakdown instead of summary | Off     |

## Examples

### Summary view (default)

```bash theme={null}
cast usage
```

Displays total invocations, input/output tokens, and total cost for the period.

### Daily breakdown

```bash theme={null}
cast usage --daily --days 7
```

Shows a table with per-day invocations, tokens, and cost.

## See Also

* [Usage API (SDK)](/sdk/usage) — Query usage programmatically
* [CLI Overview](/cli/overview) — All CLI commands
