# stats

Atuin can also calculate stats based on your history - this is currently a
little basic, but more features to come.

`atuin stats` accepts an optional period, which scopes the stats to a window of
time. Leave it blank (or pass `all`) for stats since the beginning of your
history.

| Period  | Stats window                |
| ------- | --------------------------- |
| (blank) | your entire history         |
| `all`   | your entire history         |
| `today` | since local midnight        |
| `week`  | the last 7 days             |
| `month` | the last 31 days            |
| `year`  | the last 365 days           |
| a date  | 24h starting from that date |

```console
$ atuin stats today
$ atuin stats week
$ atuin stats month
$ atuin stats year
```

## 1-day stats

Any period that isn't one of the keywords above is parsed as a date. You provide
the starting point, and Atuin computes the stats for 24h from that point.
Date parsing is provided by `interim`, which supports different formats
for full or relative dates. Certain formats rely on the dialect option in your
[configuration](/reference/config/general/#dialect) to differentiate day from month.
Refer to [the module's documentation](https://docs.rs/interim/latest/interim/#supported-formats) for more details on the supported date formats.

```console
$ atuin stats last friday

+---------------------+------------+
| Statistic           | Value      |
+---------------------+------------+
| Most used command   | git status |
+---------------------+------------+
| Commands ran        |        450 |
+---------------------+------------+
| Unique commands ran |        213 |
+---------------------+------------+

# A few more examples:
$ atuin stats 2018-04-01
$ atuin stats April 1
$ atuin stats 01/04/22
$ atuin stats last thursday 3pm  # between last thursday 3:00pm and the following friday 3:00pm
```

## Full history stats

```console
$ atuin stats
# or
$ atuin stats all

+---------------------+-------+
| Statistic           | Value |
+---------------------+-------+
| Most used command   |    ls |
+---------------------+-------+
| Commands ran        |  8190 |
+---------------------+-------+
| Unique commands ran |  2996 |
+---------------------+-------+
```