# atuin stats

<!-- Generated by web/apps/docs/scripts/gen-reference.ts from the Atuin source. Do not edit. -->

Calculate statistics for your history

```sh
atuin stats [OPTIONS] [PERIOD]...
```

## Arguments

- `<PERIOD>...`: Compute statistics for the specified period, leave blank for statistics since the beginning. See [this](https://docs.atuin.sh/18.24/reference/stats/) for more details.

## Options

- `-c <COUNT>`, `--count <COUNT>`: How many top commands to list. Default: `10`.
- `-n <NGRAM_SIZE>`, `--ngram-size <NGRAM_SIZE>`: The number of consecutive commands to consider. Default: `1`.
- `--filter-mode <FILTER_MODE>`: Filter commands by scope [global, host, session, directory, workspace]
  - `global`
  - `host`
  - `session`
  - `directory`
  - `workspace`
  - `session-preload`