aboutsummaryrefslogtreecommitdiffstats
path: root/docs/docs/commands/list.md
blob: cd41f6904d7c92a9c036a529319c851a3f9ee39e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
---
title: Listing History
---

# `atuin history list`


| Arg              | Description                                                                   |
|------------------|-------------------------------------------------------------------------------|
| `--cwd`/`-c`     | The directory to list history for (default: all dirs)                         |
| `--session`/`-s` | Enable listing history for the current session only (default: false)          |
| `--human`        | Use human-readable formatting for the timestamp and duration (default: false) |
| `--cmd-only`     | Show only the text of the command (default: false)                            |
| `--reverse`      | Reverse the order of the output (default: false)                              |
| `--format`       | Specify the formatting of a command (see below)                               |
| `--print0`       | Terminate the output with a null, for better multiline support                                                                              |


## Format

Customize the output of `history list`

Example

```
atuin history list --format "{time} - {duration} - {command}"
```

Supported variables

```
{command}, {directory}, {duration}, {user}, {host} and {time}
```