> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.astropods.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server.

# ast insights

Read the numbers on the [Insights](https://astropods.com/insights) page for the active account: total spend, each day's spend, and spend by agent and by person. Every command only reads.

```bash
ast insights <subcommand> [--days <7|14|30|90>] [--json]
```

`--days` sets how many complete days to cover: `7`, `14`, `30`, or `90`, the ranges the Insights page offers. The default is `30`. Days are complete UTC days, so today is never included, and each result names its first and last day. `--json` prints the result as JSON.

The commands read the active account. Switch it with [`ast account switch`](/cli/account#account-switch). [`ast mcp`](/cli/top-level#mcp) serves each one as an MCP tool.

## insights summary

```bash
ast insights summary [--days <n>] [--json]
```

Shows total spend, requests, tokens, and active agents, each with its change from the period of the same length before it.

## insights daily

```bash
ast insights daily [--days <n>] [--json]
```

Shows each day's spend for the five agents that spent the most in the period, as on the Insights chart. It is not a daily total: spend by other agents is left out.

## insights agents

```bash
ast insights agents [--days <n>] [--limit <n>] [--offset <n>] [--json]
```

Lists agents and dev tools, most spend first, with each one's share of the total and its requests. A deleted agent whose spend still counts is marked `(deleted)`.

`--limit` sets how many rows to show, from 1 to 100 (default 25). `--offset` skips rows, to read the next page. The output says when there are more rows.

## insights people

```bash
ast insights people [--days <n>] [--limit <n>] [--offset <n>] [--json]
```

Lists people, most spend first, with their share of the total, their tokens, and the agents they used. `--limit` and `--offset` work as for `insights agents`.

## Next steps

* [Read usage from an MCP client](/mcp-server): give an agent these numbers through `ast mcp`
* [Monitor agents](/monitor-agents): what Insights measures