.\" Generated by gen_docs from crates/datui-cli. Do not edit.
.TH DATUI\-CACHE 1 2026-10-08 "datui 0.4.4" "User Commands"
.nr HY 0
.ds AD l
.SH NAME
datui\-cache \- clear the cache
.SH SYNOPSIS
.nf
\fBdatui cache clear\fR [\fB\-\-recents\fR]
.fi
.SH DESCRIPTION
Clear the cache: recents, history, schemas and copies.
.PP
The cache holds nothing datui cannot rebuild; clearing it loses the recents' order and the prompts' history.
.SH COMMANDS
.TP
\fBdatui cache clear\fR
Delete the cache directory's contents, or with \-\-recents only the recent datasets.
.RS
.TP
\fB\-\-recents\fR
Forget the recently opened datasets and keep the rest.
.RE
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-config\fR \fIKEY=VALUE\fR
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. \fBdatui config keys\fR lists them.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help.
.SH "EXIT STATUS"
.TP
\fB0\fR
Success: the session was quit (q, Ctrl+Q or Ctrl+C), or the command did what it was asked.
.TP
\fB1\fR
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).
.TP
\fB2\fR
A usage error: an unknown option or command, or a value an option does not take.
.SH ENVIRONMENT
.TP
\fBDATUI_CACHE_DIR\fR
The cache directory, in place of the platform's (\fB~/.cache/datui\fR on Linux).
.SH FILES
\fICONFIG\fR is \fB$DATUI_CONFIG_DIR\fR when it is set, else \fB$XDG_CONFIG_HOME/datui\fR (\fB~/.config/datui\fR) on Linux, \fB~/Library/Application Support/datui\fR on macOS and \fB%APPDATA%\edatui\fR on Windows.
.PP
\fICACHE\fR is \fB$DATUI_CACHE_DIR\fR when it is set, else \fB$XDG_CACHE_HOME/datui\fR (\fB~/.cache/datui\fR) on Linux, \fB~/Library/Caches/datui\fR on macOS and \fB%LOCALAPPDATA%\edatui\fR on Windows.
.TP
\fICACHE\fR/recents_history.txt
The recent datasets the home screen lists. \fBdatui cache clear \-\-recents\fR forgets them.
.TP
\fICACHE\fR/*_history.txt
The prompts' history.
.TP
\fICACHE\fR/shapes/, \fICACHE\fR/facts/, \fICACHE\fR/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.
.TP
\fICACHE\fR/datui.log
The log, unless \fBlog.file\fR names another.
.SH EXAMPLES
Forget the recent datasets and keep the rest of the cache.
.PP
.RS 4
.EX
datui cache clear \-\-recents
.EE
.RE
.PP
Clear the whole cache: recents, prompt history, schemas and copies.
.PP
.RS 4
.EX
datui cache clear
.EE
.RE
.SH "SEE ALSO"
\fBdatui\fR(1)
.PP
The datui documentation: <https:/\:/\:derekwisong.\:github.\:io/\:datui/\:>
.SH BUGS
Report bugs at <https:/\:/\:github.\:com/\:derekwisong/\:datui/\:issues>.
.SH AUTHORS
Derek Wisong and the datui contributors.
.SH COPYRIGHT
Copyright \(co 2026 Derek Wisong
.PP
datui is free software under the MIT License.