.\" Generated by gen_docs from crates/datui-cli. Do not edit.
.TH DATUI\-CONFIG 1 2026-10-06 "datui 0.4.0" "User Commands"
.nr HY 0
.ds AD l
.SH NAME
datui\-config \- write the default config file, list the files read, or list every key
.SH SYNOPSIS
.nf
\fBdatui config init\fR [\fB\-\-force\fR]
\fBdatui config path\fR
\fBdatui config keys\fR
.fi
.SH DESCRIPTION
Write the default config file, list the files read, or list every key.
.PP
The file's keys are in datui-config(5).
.SH COMMANDS
.TP
\fBdatui config init\fR
Write the default config file, every key commented out at its default.
.RS
.TP
\fB\-\-force\fR
Replace a config file that is there.
.RE
.TP
\fBdatui config path\fR
Print the config files read, lowest precedence first.
.TP
\fBdatui config keys\fR
List every key: its type, default, the value in effect and what set it.
.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_CONFIG_DIR\fR
The config directory, in place of the platform's (\fB~/.config/datui\fR on Linux). Saved views and format specs live there too.
.TP
\fBDATUI_LOG\fR
The log level: \fBerror\fR, \fBwarn\fR, \fBinfo\fR, \fBdebug\fR, \fBtrace\fR or \fBoff\fR. Beats \fBlog.level\fR in a file; \fB\-c\fR and \fB\-\-log\-level\fR beat it.
.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.
.TP
\fICONFIG\fR/config.toml
The config file: see datui-config(5). \fBdatui config path\fR prints the files read.
.TP
\fICONFIG\fR/catalog.toml
Your catalog, which Ctrl+D on the home screen adds to: see datui-catalog(1).
.TP
\fICONFIG\fR/catalogs/
More catalogs, one *.toml each, named by its file; examples.toml replaces the bundled one.
.TP
\fICONFIG\fR/views/
Saved views: see datui-views(1).
.TP
\fICONFIG\fR/formats/
Format specs and dictionaries, searched first: see datui-formats(7).
.SH EXAMPLES
Write the config file, every key commented out at its default.
.PP
.RS 4
.EX
datui config init
.EE
.RE
.PP
The config files read, lowest precedence first.
.PP
.RS 4
.EX
datui config path
.EE
.RE
.PP
Every key: its type, default, the value in effect and what set it, here \-c.
.PP
.RS 4
.EX
datui config keys \-c display.row_numbers=true
.EE
.RE
.SH "SEE ALSO"
\fBdatui\fR(1), \fBdatui\-config\fR(5)
.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.