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

# tokens

> Analyze token usage across sessions and checkpoints.

Analyze token usage across sessions and checkpoints.

```bash theme={null}
entire tokens SUBCOMMAND
```

`entire tokens` is experimental and appears under [labs](/cli-reference/labs) while the workflow is still being refined.

Three commands report on token usage, at different scopes:

| Command                                                                   | Scope                        |
| ------------------------------------------------------------------------- | ---------------------------- |
| [`entire session tokens`](/cli-reference/session#session-tokens)          | One session                  |
| [`entire checkpoint tokens`](/cli-reference/checkpoint#checkpoint-tokens) | One checkpoint               |
| `entire tokens profile`                                                   | Committed checkpoint history |

## tokens profile

Aggregate token usage and recommendations across committed checkpoint history.

```bash theme={null}
entire tokens profile [flags]
```

| Flag        | Description                                                 |
| ----------- | ----------------------------------------------------------- |
| `--all`     | Analyze all committed checkpoints.                          |
| `--json`    | Output as JSON.                                             |
| `--limit N` | Maximum committed checkpoints to analyze. Defaults to `50`. |

```bash theme={null}
entire tokens profile
entire tokens profile --all
entire tokens profile --limit 200 --json
```

The profile reads committed checkpoint metadata only. It does not inspect transcripts or source files, so it is deterministic and adds no token cost while you diagnose token usage. By default it scans the latest 50 committed checkpoints.

## Continue With

<CardGroup cols={2}>
  <Card title="session tokens" icon="terminal" href="/cli-reference/session#session-tokens">
    Token usage and recommendations for one session.
  </Card>

  <Card title="checkpoint tokens" icon="terminal" href="/cli-reference/checkpoint#checkpoint-tokens">
    Token usage and recommendations for one checkpoint.
  </Card>
</CardGroup>