# 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](../configuration/config.md#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 |
+---------------------+-------+
```
