datui-cache - clear the cache
datui cache clear [--recents]
Clear the cache: recents, history, schemas and copies.
The cache holds nothing datui cannot rebuild; clearing it loses
the recents' order and the prompts' history.
- datui cache
clear
- Delete the cache directory's contents, or with --recents only the recent
datasets.
- --recents
- Forget the recently opened datasets and keep the rest.
- -c, --config
KEY=VALUE
- Set a config key for this run, as in the file: -c
display.row_numbers=true. Repeatable; a flag of the key's own still wins.
datui config keys lists them.
- -h, --help
- Print help.
- 0
- Success: the session was quit (q, Ctrl+Q or Ctrl+C), or the command did
what it was asked.
- 1
- An error, printed to standard error: a PATH that is not there, a
configuration file that cannot be used, nothing piped in for -, or a
command that failed (datui formats check on a spec with errors).
- 2
- A usage error: an unknown option or command, or a value an option does not
take.
- DATUI_CACHE_DIR
- The cache directory, in place of the platform's (~/.cache/datui on
Linux).
CONFIG is $DATUI_CONFIG_DIR when it is set, else
$XDG_CONFIG_HOME/datui (~/.config/datui) on Linux,
~/Library/Application Support/datui on macOS and
%APPDATA%\datui on Windows.
CACHE is $DATUI_CACHE_DIR when it is set, else
$XDG_CACHE_HOME/datui (~/.cache/datui) on Linux,
~/Library/Caches/datui on macOS and %LOCALAPPDATA%\datui on
Windows.
- CACHE/recents_history.txt
- The recent datasets the home screen lists. datui cache clear
--recents forgets them.
- CACHE/*_history.txt
- The prompts' history.
- CACHE/shapes/,
CACHE/facts/, CACHE/cloud_listings/
- What the home screen has measured of datasets and listed of cloud sources,
so it can show rows, columns and sizes without reading them again.
- CACHE/datui.log
- The log, unless log.file names another.
Forget the recent datasets and keep the rest of the cache.
datui cache clear --recents
Clear the whole cache: recents, prompt history, schemas and
copies.
datui(1)
The datui documentation:
<https://derekwisong.github.io/datui/>
Report bugs at
<https://github.com/derekwisong/datui/issues>.
Derek Wisong and the datui contributors.
Copyright © 2026 Derek Wisong
datui is free software under the MIT License.