Global command line flags
--cache
directory
Use directory as the cache directory.
--color
value
Colorize diffs, value can be on
, off
, auto
, or any boolean-like value
recognized by parseBool
. The default is auto
which will colorize diffs only
if the the environment variable $NO_COLOR
is not set and stdout is a terminal.
-c
, --config
filename
Read the configuration from filename.
--config-format
json
|toml
|yaml
Assume the configuration file is in the given format. This is only needed if
the config filename does not have an extension, for example when it is
/dev/stdin
.
-D
, --destination
directory
Use directory as the destination directory.
-n
, --dry-run
Set dry run mode. In dry run mode, the destination directory is never modified.
This is most useful in combination with the -v
(verbose) flag to print
changes that would be made without making them.
--force
Make changes without prompting.
-h
, --help
Print help.
-k
, --keep-going
Keep going as far as possible after a encountering an error.
--no-pager
Do not use the pager.
--no-tty
Do not attempt to get a TTY to read input and passwords. Instead, read them from stdin.
-o
, --output
filename
Write the output to filename instead of stdout.
--persistent-state
filename
Read and write the persistent state from filename. By default, chezmoi stores
its persistent state in chezmoistate.boltdb
in the same directory as its
configuration file.
-R
, --refresh-externals
Refresh externals cache. See .chezmoiexternal.<format>
.
-S
, --source
directory
Use directory as the source directory.
--use-builtin-age
value
Use chezmoi's builtin age encryption instead of
an external age
command. value can be on
, off
, auto
, or any
boolean-like value recognized by parseBool
. The default is auto
which will
only use the builtin age if age.command
cannot be found in $PATH
.
The builtin age
command does not support passphrases, symmetric encryption,
or the use of SSH keys.
--use-builtin-git
value
Use chezmoi's builtin git instead of git.command
for the init
and update
commands. value can be on
, off
, auto
, or any boolean-like value
recognized by parseBool
. The default is auto
which will only use the
builtin git if git.command
cannot be found in $PATH
.
Info
chezmoi's builtin git has only supports the HTTP and HTTPS transports and
does not support git-repo
externals.
-v
, --verbose
Set verbose mode. In verbose mode, chezmoi prints the changes that it is making as approximate shell commands, and any differences in files between the target state and the destination set are printed as unified diffs.
--version
Print the version of chezmoi, the commit at which it was built, and the build timestamp.
-w
, --working-tree
directory
Use directory as the git working tree directory. By default, chezmoi searches
the source directory and then its ancestors for the first directory that
contains a .git
directory.